Ryot op engem Managed VPS hosten heescht, den Historique vun deem, wat Dir kuckt, liest, spillt an trainéiert, op engem Server ze halen, deen Iech gehéiert a vun eisen Equippen Dag an Nuecht aktuell gehal a verfollegt gëtt. Ryot ass e fräien Open-Source-Tracker ënner der GPL-3.0-Lizenz, fir Filmer, Serien, Bicher, Spiller, Podcasten, Musek an Trainingen. Dëse Guide follegt sengem offiziellen Docker-Image an der Versioun v10.5.8, a mir hunn all Befeel op engem VPS vu Simafri ausgeféiert, ier mir en geschriwwen hunn: d’Installatioun mat Docker Compose a PostgreSQL, HTTPS, den éischte Kont, d’API-Schlëssele fir all Medientyp, d’Backups an d’Aktualiséierungen.
Auteur: Simon Vasconcelos Lee
Publizéiert den 19. November 2026Lieszäit: 11 Minutten
ignisda/ryot a PostgreSQL 18, mam Port 8000 op 127.0.0.1 publizéiert, hannert engem HTTPS-Reverse-Proxy.SERVER_ADMIN_ACCESS_TOKEN an e Fichier .env, a setzt FRONTEND_URL op Är ëffentlech Adress.USERS_ALLOW_REGISTRATION=false, fir d’Umeldungen op enger privater Instanz zouzemaachen.pg_dump, an aktualiséiert dann, andeems Dir den Tag vum Image ännert.Ryot, fir „Roll Your Own Tracker“ an ausgeschwat wéi „riot“, hält op enger Plaz, wat Dir gesinn, gelies, gespillt an trainéiert hutt, mat Statistiken, engem Kalenner vun deem, wat kënnt, an Ären eegene Kollektiounen. Säin Entwéckler, IgnisDa, schreift et a Rust, mat enger Webinterface, déi Dir als App op engem Telefon installéiere kënnt.
Ryot gëtt ënner der GNU General Public License, Versioun 3 (GPL-3.0) publizéiert. Dir kënnt et gratis notzen, fir Iech, Är Famill, Äre Veräin oder Är Entreprise, et kopéieren an et änneren. Wann Dir eng geännert Versioun verdeelt, verdeelt Dir hire Quellcode ënner der selwechter Lizenz. D’Software gëtt ouni Garantie zur Verfügung gestallt.
Ryot Pro ass e bezuelte Schlëssel, deen säin Entwéckler verkeeft, an deen zousätzlech Funktiounen fräischalt, wéi d’Deele vu Profiller a personaliséiert Recommandatiounen. E kënnt an eng Variabel SERVER_PRO_KEY vum selwechten Image, an de Server geet op d’Communautéitsversioun zréck, wann de Schlëssel ofleeft. Näischt an dësem Guide brauch en.
D’Dokumentatioun setzt keng Mindestgréisst fest, a Ryot ass liicht. Hei ass, wat mir op eisem Test-VPS gemooss hunn, frësch installéiert:
D’Gréisst vum Server hänkt also vun der Zuel vun de Benotzer an aneren Applikatiounen of, déi Dir nieft Ryot bedreift. Op engem Managed VPS beschreift Dir eis Är Notzung, a mir recommandéieren Iech déi passend Gréisst.
Ryot kënnt als eenzegt Image, ignisda/ryot, och als ghcr.io/ignisda/ryot publizéiert, dat souwuel d’Interface wéi och d’API um Port 8000 servéiert. Et brauch PostgreSQL 15 oder méi nei, dat dernieft a sengem eegene Container leeft. Leet op engem Server mat Docker Engine a sengem Compose-Plugin, aus dem Repository vun Docker fir Ubuntu installéiert, en Dossier wéi /opt/ryot un a setzt dës compose.yaml dran, déi op dem Fichier vun der Installatiounssäit opbaut:
services:
ryot-db:
image: postgres:18-alpine
restart: unless-stopped
environment:
- TZ=Europe/Amsterdam
- POSTGRES_DB=ryot
- POSTGRES_USER=ryot
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD:?set POSTGRES_PASSWORD in .env}
volumes:
- postgres_storage:/var/lib/postgresql
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ryot -d ryot"]
interval: 5s
timeout: 5s
retries: 10
ryot:
image: ignisda/ryot:v10.5.8
restart: unless-stopped
ports:
- "127.0.0.1:8000:8000"
environment:
- TZ=Europe/Amsterdam
- FRONTEND_URL=https://ryot.example.com
- DATABASE_URL=postgres://ryot:${POSTGRES_PASSWORD}@ryot-db:5432/ryot
- SERVER_ADMIN_ACCESS_TOKEN=${SERVER_ADMIN_ACCESS_TOKEN:?set SERVER_ADMIN_ACCESS_TOKEN in .env}
depends_on:
ryot-db:
condition: service_healthy
volumes:
postgres_storage:
Déi zwee Geheimnisser kommen an e Fichier .env dernieft, deen Docker Compose eleng liest. Leet en esou un, datt nëmme root en liese kann, a start dann de Stack:
umask 077
printf 'POSTGRES_PASSWORD=%s\nSERVER_ADMIN_ACCESS_TOKEN=%s\n' "$(openssl rand -hex 24)" "$(openssl rand -hex 32)" > .env
umask 022
docker compose up -d
docker compose ps
127.0.0.1 publizéiert: de Referenzfichier publizéiert en ouni Adress, an Docker mécht en dann op allen Adresse vum Server op. Lokal publizéiert, ass en nëmmen iwwer de Reverse Proxy z’erreechen.postgres als Benotzer a Passwuert. Hei kritt en eegene Benotzer ryot en zoufällegt Passwuert, hexadezimal, fir datt et an DATABASE_URL keen Escapen brauch.SERVER_ADMIN_ACCESS_TOKEN ass obligatoresch: en autoriséiert d’Administrateursoperatiounen iwwer d’API, a verschlësselt d’Geheimnisser vun der Zwee-Faktor-Authentifikatioun vun Äre Benotzer. Haalt en geheim, a loosst en onverännert: mat engem aneren Token kënnen dës Geheimnisser net méi gelies ginn.FRONTEND_URL ass Är ëffentlech Adress, mat https://. Ryot benotzt se als Basis fir d’Linken, déi et generéiert, an OpenID Connect brauch se.TZ ass d’Zäitzon vun de geplangten Aufgaben, standardméisseg GMT: setzt Är, aus der IANA-Lëscht.v10 mat pull_policy: always, wat bei all Start all kleng Versioun follegt. Mat enger kompletter Versiounsnummer, hei v10.5.8, decidéiert Dir selwer, wéini all Aktualiséierung kënnt.postgres_storage hält all Är Donnéeën. PostgreSQL 18 leet se ënner /var/lib/postgresql of, dofir gëtt de Volume do montéiert an net op /var/lib/postgresql/data wéi bei méi alen Versiounen.Den éischte Start féiert d’Migratioune vun der Datebank aus a lued de Katalog vun den Übungen erof; op eisem Test-VPS huet Ryot an e puer Sekonnen geäntwert. Fir ze kontrolléieren, ob et äntwert:
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8000/health
curl -s http://127.0.0.1:8000/backend/config | head -c 300
Den éischte Befeel äntwert 200. Deen zweete gëtt d’Konfiguratioun zréck, déi de Server gelueden huet, als JSON, mat verstoppte Geheimnisser: e praktesche Wee, fir eng Variabel ze kontrolléieren.
De Container servéiert Ryot iwwer HTTP, um Port 8000. HTTPS iwwerhëlt e Reverse Proxy, deen dervirsteet an deen den ëffentlechen Header Host an X-Forwarded-Proto weiderginn muss. Mir hunn Caddy getest, aus sengem offiziellen Repository fir Debian an Ubuntu installéiert: et kritt d’Zertifikat vu Let’s Encrypt selwer, erneiert et a gëtt dës Headeren standardméisseg weider.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.Ryot huet kee Standardkont, an d’Umeldunge sinn op enger neier Instanz op. Den éischte Kont, deen ugeluecht gëtt, kritt d’Roll Admin; déi nächst sinn normal Benotzer. Leet Äre Kont direkt nom éischte Start un:
Fir eng privat Instanz maacht Dir d’Umeldungen zou: setzt USERS_ALLOW_REGISTRATION=false an d’Ëmfeld vum Service ryot, a féiert dann docker compose up -d aus. Op eisem Test-VPS ass de Link „Create a new account?“ verschwonnen, an eng Umeldung, déi vun der Umeldungsadress aus probéiert gouf, gouf vum Server mat „Registration is disabled“ refuséiert.
Mir hunn et mat zouenen Umeldunge getest: den invitéierte Kont gouf als normale Benotzer ugeluecht, säi Passwuert gouf iwwer de Link festgeluecht, an hien ass op säin eegenen Dashboard komm.
Fir Iech amplaz mat de Konte vun Ärer Entreprise unzemellen, ënnerstëtzt Ryot OpenID Connect: setzt SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET an SERVER_OIDC_ISSUER_URL, a gitt bei Ärem Ubidder https://ryot.example.com/api/auth als Weiderleedungsadress un.
Ryot fënnt d’Detailer an d’Covere vun all Medientyp bei engem Ubidder. E puer funktionéieren ouni Schlëssel, aner brauchen Ären, well déi gedeelt Schlësselen an der v9 ewechgeholl goufen:
| Medien | Ubidder | Wat ze setzen ass |
|---|---|---|
| Bicher | Open Library | Näischt: et funktionéiert direkt. Google Books an Hardcover sinn optional, mat hirem API-Schlëssel |
| Filmer a Serien | TMDB, oder TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, den API Read Access Token vun engem gratis TMDB-Kont, oder MOVIES_AND_SHOWS_TVDB_API_KEY |
| Videospiller | IGDB, iwwer Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID an VIDEO_GAMES_TWITCH_CLIENT_SECRET, vun enger Applikatioun an der Entwécklerkonsol vun Twitch |
| Musek | Spotify, optional | MUSIC_SPOTIFY_CLIENT_ID an MUSIC_SPOTIFY_CLIENT_SECRET |
| Import vun Animeen | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, nëmme néideg, fir aus MyAnimeList z’importéieren |
Dës Schlëssele sinn Geheimnisser: setzt se an de Fichier .env, setzt eng Zeil wéi - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} an d’Ëmfeld vum Service ryot, a féiert dann docker compose up -d aus. D’Konfiguratiounssäit vun der Dokumentatioun zielt all déi aner Variabelen op.
Alles läit op zwou Plazen: an der PostgreSQL-Datebank, am Volume postgres_storage, an an Ärem Fichier .env. Haalt dee leschte sécher: SERVER_ADMIN_ACCESS_TOKEN ass néideg, fir d’Zwee-Faktor-Geheimnisser ze liesen, déi an der Datebank gespäichert sinn. D’PostgreSQL-Image enthält pg_dump. Den Dump hält all Kont a säin Historique, leet en also esou un, datt nëmme root en liese kann, mat umask 077 an Klameren: de Rescht vun Ärer Sessioun behält seng gewéinlech Mask. E Fichier, deen et scho gëtt, behält seng Rechter, wann en iwwerschriwwe gëtt, dofir mécht d’Zeil find d’Dumps an d’Kopien, déi schonn am Dossier leien, fir d’éischt zou, ier iergendeppes geschriwwe gëtt, a stoppt d’Backup, wann et net geet:
(
umask 077
find . -maxdepth 1 \( -name 'ryot-*.dump' -o -name 'env-*.bak' \) -exec chmod 600 {} + || exit 1
docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot > ryot-$(date +%F).dump
cp .env env-$(date +%F).bak
)
Plangt dës Kopie an a schéckt se baussent de Server. Um Disk geluecht, kommen d’Dumps och an d’Backups vum Server vun der Nuecht.
Op der selwechter oder enger neier Installatioun, mat der selwechter .env, stoppt Dir d’Applikatioun, ersetzt d’Datebank duerch eng eidel, luet den Dump do eran a start d’Applikatioun dann nees:
docker compose stop ryot &&
docker compose exec -T ryot-db dropdb -U ryot ryot &&
docker compose exec -T ryot-db createdb -U ryot ryot &&
docker compose exec -T ryot-db pg_restore -U ryot -d ryot --exit-on-error --no-owner < ryot-2026-11-20.dump &&
docker compose start ryot
--exit-on-error stoppt d’Restauratioun beim éischte Feeler, amplaz weiderzemaachen an d’Feeler um Enn ze mellen, an d’&& stoppen d’Sequenz do: Ryot bleift gestoppt. Wat virum Feeler gelueden gouf, bleift an der Datebank, fänkt also nees bei dropdb un, soubal d’Ursaach behuewen ass.Mir hunn de ganze Zyklus op eisem VPS mat genee dëse Befeeler getest: Dump, d’Datebank geläscht an eidel nei ugeluecht, Restauratioun. Déi zwee Konten, hir Kollektiounen an déi 876 Übunge sinn erëmkomm, an den Administrateur huet sech direkt nees ageloggt.
Ryot exportéiert och Är eegen Donnéeën als JSON, vun der Astellungssäit „Imports and Exports“ aus, an et kann se nees importéieren. Dësen Export brauch e S3-kompatibele Fichierspäicher; den Dump vun der Datebank uewe funktionéiert ouni en.
Ryot kënnt dacks eraus, ongeféier all Woch. Liest d’Release Notes, maacht eng Backup, ännert den Tag vum Image an der compose.yaml, luet dann dat neit Image erof a maacht de Container nei. D’Migratioune vun der Datebank lafen eleng beim Start:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop follegt der Haaptbranche: d’Dokumentatioun warnt, datt en dacks grouss Feeler huet an Donnéeë verléiere kann. Bleift bei de Versiounen.Ryot sammelt anonym Notzungsdonnéeën, Säitenopruffer an e puer Evenementer, op enger selwer gehoster Umami-Instanz vu sengem Entwéckler. Fir se auszeschalten, setzt DISABLE_TELEMETRY=true an d’Ëmfeld vum Service ryot, a féiert dann docker compose up -d aus.
Selwer hosten heescht, de Server zousätzlech zur Applikatioun ze halen. Op engem Managed VPS huelen eis Equippen de Server an d’Hand a verfollegen Är Instanz proaktiv; Ryot bleift Är Software, mat Ärem Historique an Ären Astellungen.
| Thema | Eis Equippen | Dir |
|---|---|---|
| De Server | System- a Sécherheetsupdates, Interventioune um Server abegraff | De Moment, deen Iech passt |
| D’Iwwerwaachung | Server 24 Stonnen op 24 a 7 Deeg op 7 verfollegt, mat Interventioun, ouni op Ären Uruff ze waarden | Ären Historique, Är Kollektiounen an Är Integratiounen an Ryot |
| Ryot | Proaktiv Suivi: Feeler, lues Äntwertzäiten, Datebank a Späicherplaz erkannt, Korrektur recommandéiert | Seng Installatioun, seng Aktualiséierungen, seng API-Schlësselen a seng Astellungen, déi Dir ëmsetzt, selwer oder mat Ärem KI-Assistent |
| D’Benotzer | De Server, deen se dréit, iwwerwaacht a gesécheert | D’Konten, d’Umeldungen an de Single Sign-on |
| D’Backups | All Nuecht, verschlësselt a baussent der Maschinn gelagert; Restauratioun abegraff | D’Dumps vun der Datebank an d’JSON-Exporter, déi Ryot eegen sinn, an d’Ufro fir eng Restauratioun, wann Dir se braucht |
| D’Migratioun | Äre bestoende Server migréiert, offréiert | De Moment vum Wiessel |
Wann Dir léiwer wëllt, datt eis Equippen an der Applikatioun selwer intervenéieren, gëtt dës Prestatioun op Stonnebasis oder pauschal verrechent, mat engem Käschtevirschlag, deen Iech virun der Interventioun matgedeelt gëtt.
Mat engem Managed VPS vu Simafri halen eis Equippen de Server vun Ärer Ryot-Instanz aktuell, iwwerwaachen en Dag an Nuecht a gräifen an, ouni op Ären Uruff ze waarden; si verfollegen och Är Instanz proaktiv a recommandéieren Iech déi nëtzlech Korrekturen, déi Dir ëmsetzt, selwer oder mat Ärem KI-Assistent. D’Backups ginn all Nuecht verschlësselt a baussent der Maschinn gelagert, hir Restauratioun ass abegraff, an d’Migratioun vun Ärem aktuelle Server ass offréiert.
Jo. Ryot steet ënner der GPL-3.0-Lizenz: Dir kënnt et fir Iech, Är Famill oder Är Equipe bedreiwen, ouni eng Lizenz ze kafen. Ryot Pro ass en optionale bezuelte Schlëssel, deen deemselwechten Image Funktiounen derbäisetzt. Et bleiwen d’Käschte vum Server, op deem et leeft.
Benotzt d’Image ignisda/ryot a PostgreSQL 18 an enger compose.yaml. Setzt d’Passwuert vun der Datebank an SERVER_ADMIN_ACCESS_TOKEN an e Fichier .env, setzt FRONTEND_URL op Är https-Adress, publizéiert de Port 8000 op 127.0.0.1, start docker compose up -d a setzt en HTTPS-Reverse-Proxy dervir.
Et gëtt keen. Klickt op der Loginsäit op „Create a new account?“: den éischte Kont, deen ugeluecht gëtt, gëtt Administrateur. Setzt duerno USERS_ALLOW_REGISTRATION=false, fir d’Umeldungen zouzemaachen; den Administrateur invitéiert déi aner Benotzer ënner Settings, Users, mat engem Eemollink.
Zënter der v9 brauche Filmer a Serien Ären eegenen TMDB-Token: leet e gratis TMDB-Kont un, frot en API-Schlëssel un, a setzt säin API Read Access Token an MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Videospiller brauchen eng Twitch-Applikatioun, wärend Bicher ouni Schlëssel funktionéieren.
Wéineg. Op eisem Test-VPS huet eng frësch Installatioun ongeféier 240 bis 300 MB fir Ryot an 70 MB fir PostgreSQL benotzt, an déi zwee Imagen huelen ongeféier 810 MB um Disk.
Maacht en Dump vun der PostgreSQL-Datebank mat docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot ënner umask 077, fir datt nëmme root en liese kann, a behaalt eng Kopie vun Ärem Fichier .env. Fir ze restauréieren, stoppt d’Applikatioun, leet d’Datebank mat dropdb a createdb eidel nei un, a luet dann den Dump mat pg_restore --exit-on-error --no-owner.
Liest d’Release Notes a maacht eng Backup, ännert den Tag vum Image an der compose.yaml, a féiert dann docker compose pull an docker compose up -d aus. D’Migratioune vun der Datebank lafen eleng beim Start. Tëscht Haaptversioune follegt Dir der Migratiounssäit.
E Managed VPS deckt de Server of: System, Sécherheet, Iwwerwaachung a Backups. Eis Equippen verfollegen och Är Instanz proaktiv a recommandéieren Iech déi nëtzlech Korrekturen, déi Dir ëmsetzt. Eng Interventioun an der Applikatioun gëtt op Stonnebasis oder pauschal verrechent.
Simafri
Loosst eis iwwer Är Websäit schwätzen
Erzielt eis vun Ärem Projet a wéinege Wierder: mir mellen eis séier bei Iech.
Merci! Är Ufro gouf geschéckt. Mir mellen eis séier bei Iech.
Léiwer per E-Mail? Schreift eis op support@simafri.com.