Ryot hosten op een Managed VPS: uw tracker voor media en fitness

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.

Simon Vasconcelos Lee Door Gepubliceerd op 19 november 2026Leestijd: 11 minuten

Alle gidsen

In het kort

  1. Dankzij de GPL-3.0-licentie draait u Ryot voor uzelf, uw gezin of uw club zonder een licentie te kopen; Ryot Pro, een betaalde sleutel, voegt functies toe bovenop dezelfde image.
  2. Installeer het met Docker Compose: de image ignisda/ryot en PostgreSQL 18, met poort 8000 gepubliceerd op 127.0.0.1 achter een reverse proxy met HTTPS.
  3. Zet het wachtwoord van de database en SERVER_ADMIN_ACCESS_TOKEN in een bestand .env, en stel FRONTEND_URL in op uw openbare adres.
  4. Het eerste account dat u aanmaakt, wordt beheerder; zet daarna USERS_ALLOW_REGISTRATION=false om de registraties op een privé-instantie te sluiten.
  5. Boeken werken meteen; films en series hebben een TMDB-token nodig, videogames een Twitch-applicatie. Maak back-ups met pg_dump, en werk daarna bij door de tag van de image te wijzigen.

Wat Ryot doet

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.

Wat de GPL-3.0-licentie toestaat

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 middelen waarmee u rekent

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.

De installatie met Docker Compose

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:

compose.yaml
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:

Terminal, in /opt/ryot
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

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:

Terminal
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.

HTTPS: de reverse proxy

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.

/etc/caddy/Caddyfile
ryot.example.com {
	reverse_proxy 127.0.0.1:8000
}
Terminal
sudo systemctl reload caddy

Het eerste account, de registraties en de uitnodigingen

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:

  1. Open uw adres: Ryot toont zijn aanmeldpagina.
  2. Klik op “Create a new account?” en vul daarna een gebruikersnaam en tweemaal een wachtwoord in.
  3. Registreer u en meld u daarna aan met uw nieuwe gegevens: u komt op het dashboard terecht, met een rondleiding.
  4. Onder “Settings”, “Users” verschijnt uw account met de rol Admin.

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”.

De andere gebruikers uitnodigen

  1. Klik onder “Settings”, “Users” op de knop + naast de titel.
  2. Vul de gebruikersnaam van de persoon in: Ryot maakt het account aan en toont een eenmalige link.
  3. Stuur de link door: de persoon opent hem, kiest een wachtwoord en meldt zich daarna aan.

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.

Films, series en games: de API-sleutels

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:

MediaBronWat u instelt
BoekenOpen LibraryNiets: het werkt meteen. Google Books en Hardcover zijn optioneel, met hun API-sleutel
Films en seriesTMDB, of TVDBMOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, het API Read Access Token van een gratis TMDB-account, of MOVIES_AND_SHOWS_TVDB_API_KEY
VideogamesIGDB, via TwitchVIDEO_GAMES_TWITCH_CLIENT_ID en VIDEO_GAMES_TWITCH_CLIENT_SECRET, van een applicatie in de ontwikkelaarsconsole van Twitch
MuziekSpotify, optioneelMUSIC_SPOTIFY_CLIENT_ID en MUSIC_SPOTIFY_CLIENT_SECRET
Anime-importMyAnimeListANIME_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.

De back-ups

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:

Terminal, in /opt/ryot
(
  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.

Terugzetten

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:

Terminal, in /opt/ryot
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

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.

De updates

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:

Terminal, in /opt/ryot
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration

Telemetrie

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.

Wie doet wat op een managed VPS

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.

OnderwerpOns teamU
De serverSysteem- en beveiligingsupdates, ingrepen op de server inbegrepenHet moment dat u past
De monitoringServer 24 uur per dag en 7 dagen per week bewaakt, met ingrijpen zonder op uw oproep te wachtenUw geschiedenis, uw collecties en uw integraties in Ryot
RyotProactief toezicht: fouten, vertragingen, database en schijfruimte opgespoord, correctie aangeradenDe installatie, de updates, de API-sleutels en de instellingen, die u toepast, zelf of via uw AI-assistent
De gebruikersDe server die ze draagt, bewaakt en geback-uptDe accounts, de registraties en single sign-on
De back-upsElke nacht, versleuteld en buiten de machine bewaard; terugzetten inbegrepenDe eigen databasedumps en JSON-exports van Ryot, en het verzoek om terug te zetten, wanneer u dat nodig hebt
De migratieUw huidige server gemigreerd, gratisHet 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.

Ryot, op een server die voor u wordt beheerd

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.

Ontdek Managed VPS

Veelgestelde vragen

Is Ryot 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.

Hoe installeer ik Ryot met Docker Compose?

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.

Wat zijn de standaard inloggegevens van Ryot?

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.

Waarom vindt Ryot geen films of series?

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.

Hoeveel geheugen heeft Ryot nodig?

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.

Hoe maak ik een back-up van Ryot?

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.

Hoe werk ik Ryot bij?

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.

Dekt een managed VPS ook Ryot?

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.

Gerelateerde gidsen

PostgreSQL op een VPS: geheugen en schijf dimensionerenEen snelle PostgreSQL-database is een database waarvan de vaak geraadpleegde gegevens in het geheugen passen. De hele dimensionering vertrekt daarvan: de omvang van de database, het deel dat echt wordt gebruikt, het aantal verbindingen, en daarna de schijf en de marge erop. Deze gids geeft de methode, de startinstellingen voor 4, 8 en 16 GB geheugen, en de query’s die een bestaande database meten.Back-ups van een VPS: wat u controleert voordat u tekentEen VPS-aanbod vermeldt bijna altijd “back-ups inbegrepen”. Achter die twee woorden kan een kopie zitten die elke nacht wordt gemaakt, buiten de machine wordt bewaard en door experts wordt teruggezet, of een snapshot op dezelfde schijf als de server. Deze gids geeft de vragen die het verschil maken, wat elk antwoord betekent, en de manier om te controleren dat een back-up terug te zetten is.Actual Budget hosten op een Managed VPS: uw budgetten op uw eigen serverActual Budget hosten op een Managed VPS betekent dat uw budgetten en hun synchronisatie op een machine blijven die van u is, en die ons team bijwerkt en dag en nacht in de gaten houdt. Actual Budget is een local-first hulpmiddel voor persoonlijke financiën, gepubliceerd onder de MIT-licentie. Deze gids volgt de officiële documentatie: de rol van de server, de installatie met Docker Compose, HTTPS, het serverwachtwoord, OpenID, end-to-endversleuteling, de banksynchronisatie, back-ups en updates.
Neem contact op