Ryot hosten op een Managed VPS betekent dat de geschiedenis van wat u kijkt, leest, speelt en tilt op een server blijft die van u is, en die ons team bijwerkt en dag en nacht in de gaten houdt. Ryot is een vrije, open source tracker onder de GPL-3.0-licentie, voor films, series, boeken, games, podcasts, muziek en trainingen. Deze gids volgt de officiële Docker-image in versie v10.5.8, en we hebben elke opdracht op een VPS van Simafri uitgevoerd voordat we hem schreven: de installatie met Docker Compose en PostgreSQL, HTTPS, het eerste account, de API-sleutels van elk mediatype, back-ups en updates.
Door Simon Vasconcelos Lee
Gepubliceerd op 19 november 2026Leestijd: 11 minuten
ignisda/ryot en PostgreSQL 18, met poort 8000 gepubliceerd op 127.0.0.1 achter een reverse proxy met HTTPS.SERVER_ADMIN_ACCESS_TOKEN in een bestand .env, en stel FRONTEND_URL in op uw openbare adres.USERS_ALLOW_REGISTRATION=false om de registraties op een privé-instantie te sluiten.pg_dump, en werk daarna bij door de tag van de image te wijzigen.Ryot, voor “Roll Your Own Tracker” en uitgesproken als “riot”, bewaart op één plek wat u hebt gezien, gelezen, gespeeld en getraind, met statistieken, een kalender van wat eraan komt en eigen collecties. Zijn ontwikkelaar, IgnisDa, schrijft het in Rust, met een webinterface die u als app op een telefoon kunt installeren.
Ryot wordt gepubliceerd onder de GNU General Public License, versie 3 (GPL-3.0). U kunt het kosteloos gebruiken, voor uzelf, uw gezin, uw club of uw bedrijf, en het kopiëren en wijzigen. Als u een gewijzigde versie verspreidt, verspreidt u de broncode ervan onder dezelfde licentie. De software wordt geleverd zonder garantie.
Ryot Pro is een betaalde sleutel die zijn ontwikkelaar verkoopt, en die extra functies ontgrendelt, zoals het delen van profielen en persoonlijke aanbevelingen. Ze gaat in een variabele SERVER_PRO_KEY van dezelfde image, en de server keert terug naar de communityversie als de sleutel verloopt. Niets in deze gids heeft haar nodig.
De documentatie legt geen minimale grootte vast, en Ryot is licht. Dit hebben we gemeten op onze test-VPS, vers geïnstalleerd:
De grootte van de server hangt dus af van het aantal gebruikers en van de andere applicaties die u naast Ryot draait. Op een managed VPS beschrijft u ons uw gebruik, en wij raden u de juiste grootte aan.
Ryot wordt geleverd als één enkele image, ignisda/ryot, ook gepubliceerd als ghcr.io/ignisda/ryot, die zowel de interface als de API serveert op poort 8000. Het heeft PostgreSQL 15 of hoger nodig, dat ernaast draait in een eigen container. Maak op een server met Docker Engine en zijn Compose-plug-in, geïnstalleerd vanuit de repository van Docker voor Ubuntu, een map aan zoals /opt/ryot en zet daarin deze compose.yaml, gebaseerd op het bestand van de installatiepagina:
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:
De twee geheimen gaan in een bestand .env ernaast, dat Docker Compose vanzelf inleest. Maak het aan zodat alleen root het kan lezen, en start daarna 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: het referentiebestand publiceert hem zonder adres, en Docker opent hem dan op alle adressen van de server. Lokaal gepubliceerd is hij alleen bereikbaar via de reverse proxy.postgres als gebruiker en wachtwoord. Hier krijgt een eigen gebruiker ryot een willekeurig wachtwoord, hexadecimaal zodat het in DATABASE_URL geen escaping nodig heeft.SERVER_ADMIN_ACCESS_TOKEN is verplicht: het staat beheerdershandelingen via de API toe, en het versleutelt de geheimen voor tweestapsverificatie van uw gebruikers. Houd het geheim, en houd het stabiel: met een ander token zijn die geheimen niet meer te lezen.FRONTEND_URL is uw openbare adres, met https://. Ryot gebruikt het als basis voor de links die het genereert, en OpenID Connect heeft het nodig.TZ is de tijdzone van de geplande taken, standaard GMT: zet de uwe, uit de IANA-lijst.v10 voor met pull_policy: always, dat bij elke start elke kleine versie volgt. Met een volledige versie, hier v10.5.8, kiest u zelf wanneer elke update gebeurt.postgres_storage bevat al uw gegevens. PostgreSQL 18 bewaart ze onder /var/lib/postgresql, daarom wordt het volume daar gekoppeld en niet aan /var/lib/postgresql/data zoals bij oudere versies.De eerste start voert de migraties van de database uit en downloadt de oefeningencatalogus; op onze test-VPS antwoordde Ryot binnen enkele seconden. Om te controleren of het antwoordt:
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
De eerste opdracht antwoordt 200. De tweede geeft de configuratie terug die de server heeft geladen, als JSON, met de geheimen weggelaten: een handige manier om een variabele te controleren.
De container serveert Ryot via HTTP, op poort 8000. HTTPS komt voor rekening van een reverse proxy die ervoor staat, en die de openbare header Host en X-Forwarded-Proto moet doorgeven. Wij hebben Caddy getest, geïnstalleerd vanuit zijn officiële repository voor Debian en Ubuntu: het haalt het certificaat van Let’s Encrypt zelf op, vernieuwt het, en geeft deze headers standaard door.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.Ryot heeft geen standaardaccount, en de registraties staan open op een nieuwe instantie. Het eerste account dat wordt aangemaakt, krijgt de rol Admin; de volgende zijn gewone gebruikers. Maak het uwe aan direct na de eerste start:
Sluit voor een privé-instantie de registraties: voeg USERS_ALLOW_REGISTRATION=false toe aan de omgeving van de dienst ryot, en voer daarna docker compose up -d uit. Op onze test-VPS verdween de link “Create a new account?”, en een registratie die vanaf het registratieadres werd geprobeerd, werd door de server geweigerd met “Registration is disabled”.
We hebben het getest met gesloten registraties: het uitgenodigde account werd als gewone gebruiker aangemaakt, het wachtwoord werd via de link ingesteld, en het account kwam op zijn eigen dashboard terecht.
Om u in plaats daarvan met de accounts van uw bedrijf aan te melden, ondersteunt Ryot OpenID Connect: stel SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET en SERVER_OIDC_ISSUER_URL in, en geef bij uw provider https://ryot.example.com/api/auth op als doorverwijsadres.
Ryot haalt de gegevens en covers van elk mediatype op bij een bron. Sommige werken zonder sleutel, andere hebben de uwe nodig, omdat de gedeelde sleutels in v9 zijn verwijderd:
| Media | Bron | Wat u instelt |
|---|---|---|
| Boeken | Open Library | Niets: het werkt meteen. Google Books en Hardcover zijn optioneel, met hun API-sleutel |
| Films en series | TMDB, of TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, het API Read Access Token van een gratis TMDB-account, of MOVIES_AND_SHOWS_TVDB_API_KEY |
| Videogames | IGDB, via Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID en VIDEO_GAMES_TWITCH_CLIENT_SECRET, van een applicatie in de ontwikkelaarsconsole van Twitch |
| Muziek | Spotify, optioneel | MUSIC_SPOTIFY_CLIENT_ID en MUSIC_SPOTIFY_CLIENT_SECRET |
| Anime-import | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, alleen nodig om te importeren uit MyAnimeList |
Deze sleutels zijn geheimen: zet ze in het bestand .env, voeg een regel zoals - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} toe aan de omgeving van de dienst ryot, en voer daarna docker compose up -d uit. De configuratiepagina van de documentatie somt alle andere variabelen op.
Alles staat op twee plaatsen: de PostgreSQL-database, in het volume postgres_storage, en uw bestand .env. Bewaar dat laatste veilig: SERVER_ADMIN_ACCESS_TOKEN is nodig om de geheimen voor tweestapsverificatie in de database te lezen. De image van PostgreSQL bevat pg_dump. De dump bevat elk account en zijn geschiedenis; maak hem dus aan zodat alleen root hem kan lezen, met umask 077 tussen haakjes: de rest van uw sessie behoudt zijn gewone masker. Een bestand dat al bestaat, behoudt zijn rechten wanneer het wordt overschreven; daarom sluit de regel find eerst de dumps en kopieën die al in de map staan af, voordat er iets wordt geschreven, en stopt hij de back-up als dat niet lukt:
(
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
)
Plan deze kopie in en stuur haar buiten de server. Op de schijf opgeslagen, gaan de dumps ook mee in de nachtelijke back-ups van de server.
Stop op dezelfde of een nieuwe installatie, met dezelfde .env, de applicatie, vervang de database door een lege, laad de dump erin, en start de applicatie daarna opnieuw:
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 stopt het terugzetten bij de eerste fout, in plaats van door te gaan en de fouten aan het einde te melden, en de && stoppen de reeks daar: Ryot blijft gestopt. Wat vóór de fout is geladen, blijft in de database staan; begin dus opnieuw vanaf dropdb zodra de oorzaak is verholpen.We hebben de hele cyclus op onze VPS getest met precies deze opdrachten: dump, de database verwijderd en leeg opnieuw aangemaakt, terugzetten. De twee accounts, hun collecties en de 876 oefeningen kwamen terug, en de beheerder kon zich meteen weer aanmelden.
Ryot exporteert uw eigen gegevens ook als JSON, vanuit de instellingenpagina “Imports and Exports”, en kan ze weer importeren. Die export heeft S3-compatibele bestandsopslag nodig; de databasedump hierboven werkt zonder.
Ryot verschijnt vaak, ruwweg elke week. Lees de release notes, maak een back-up, wijzig de tag van de image in de compose.yaml, en haal daarna de nieuwe image op en maak de container opnieuw aan. De migraties van de database lopen vanzelf bij het opstarten:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop volgt de hoofdtak: de documentatie waarschuwt dat die vaak ernstige bugs heeft en gegevens kan verliezen. Blijf bij de versies.Ryot verzamelt anonieme gebruiksgegevens, paginaweergaven en enkele gebeurtenissen, op een self-hosted Umami-instantie van zijn ontwikkelaar. Om dat uit te schakelen, voegt u DISABLE_TELEMETRY=true toe aan de omgeving van de dienst ryot, en voert u daarna docker compose up -d uit.
Self-hosting vraagt dat u naast de applicatie ook de server beheert. Op een managed VPS neemt ons team de server voor zijn rekening en houdt het uw instantie proactief in de gaten; Ryot blijft uw software, met uw geschiedenis en uw instellingen.
| Onderwerp | Ons team | U |
|---|---|---|
| De server | Systeem- en beveiligingsupdates, ingrepen op de server inbegrepen | Het moment dat u past |
| De monitoring | Server 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachten | Uw geschiedenis, uw collecties en uw integraties in Ryot |
| Ryot | Proactief toezicht: fouten, vertragingen, database en schijfruimte opgespoord, correctie aangeraden | De installatie, de updates, de API-sleutels en de instellingen, die u toepast, zelf of via uw AI-assistent |
| De gebruikers | De server die ze draagt, bewaakt en geback-upt | De accounts, de registraties en single sign-on |
| De back-ups | Elke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepen | De eigen databasedumps en JSON-exports van Ryot, en het verzoek om terug te zetten, wanneer u dat nodig hebt |
| De migratie | Uw huidige server gemigreerd, gratis | Het moment van de overschakeling |
Wilt u liever dat ons team in de applicatie zelf ingrijpt, dan wordt die dienstverlening per uur of tegen een vast bedrag gefactureerd, met een offerte voordat het werk begint.
Met een Managed VPS van Simafri houdt ons team de server van uw Ryot-instantie up-to-date, bewaakt hem dag en nacht en grijpt in zonder op uw oproep te wachten; het houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast, zelf of via uw AI-assistent. De back-ups worden elke nacht versleuteld en buiten de machine bewaard, het terugzetten is inbegrepen, en de migratie van uw huidige server is gratis.
Ja. Ryot valt onder de GPL-3.0-licentie: u kunt het draaien voor uzelf, uw gezin of uw team zonder een licentie te kopen. Ryot Pro is een optionele betaalde sleutel die functies toevoegt aan dezelfde image. Wat overblijft, zijn de kosten van de server waarop het draait.
Gebruik de image ignisda/ryot en PostgreSQL 18 in een compose.yaml. Zet het wachtwoord van de database en SERVER_ADMIN_ACCESS_TOKEN in een bestand .env, stel FRONTEND_URL in op uw https-adres, publiceer poort 8000 op 127.0.0.1, start docker compose up -d en zet er een reverse proxy met HTTPS voor.
Die zijn er niet. Klik op de aanmeldpagina op “Create a new account?”: het eerste account dat wordt aangemaakt, wordt beheerder. Zet daarna USERS_ALLOW_REGISTRATION=false om de registraties te sluiten; de beheerder nodigt de andere gebruikers uit vanuit Settings, Users, met een eenmalige link.
Sinds v9 hebben films en series uw eigen TMDB-token nodig: maak een gratis TMDB-account aan, vraag een API-sleutel aan, en zet het API Read Access Token ervan in MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Videogames hebben een Twitch-applicatie nodig, terwijl boeken zonder sleutel werken.
Weinig. Op onze test-VPS gebruikte een verse installatie ongeveer 240 tot 300 MB voor Ryot en 70 MB voor PostgreSQL, en de twee images nemen ongeveer 810 MB schijfruimte in.
Dump de PostgreSQL-database met docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot onder umask 077, zodat alleen root hem kan lezen, en bewaar een kopie van uw bestand .env. Om terug te zetten, stopt u de applicatie, maakt u de database leeg opnieuw aan met dropdb en createdb, en laadt u daarna de dump met pg_restore --exit-on-error --no-owner.
Lees de release notes en maak een back-up, wijzig de tag van de image in compose.yaml, en voer daarna docker compose pull en docker compose up -d uit. De migraties van de database lopen vanzelf bij het opstarten. Volg tussen hoofdversies de migratiepagina.
Een managed VPS dekt de server: systeem, beveiliging, monitoring en back-ups. Ons team houdt ook uw instantie proactief in de gaten en raadt u de nuttige correcties aan, die u toepast. Een ingreep in de applicatie wordt per uur of tegen een vast bedrag gefactureerd.
Simafri
Laten we het over uw website hebben
Vertel ons in een paar woorden over uw project: wij nemen snel contact met u op.
Bedankt! Uw aanvraag is verzonden. We nemen spoedig contact met u op.
Liever per e-mail? Schrijf ons op support@simafri.com.