Ryot auf einem Managed VPS zu hosten heißt, den Verlauf dessen, was Sie schauen, lesen, spielen und stemmen, auf einem Server zu behalten, der Ihnen gehört und den unsere Teams aktuell halten und Tag und Nacht beaufsichtigen. Ryot ist ein freier, quelloffener Tracker unter der GPL-3.0-Lizenz, für Filme, Serien, Bücher, Spiele, Podcasts, Musik und Workouts. Dieser Leitfaden folgt dem offiziellen Docker-Image in Version v10.5.8, und wir haben jeden Befehl vor dem Schreiben auf einem VPS von Simafri ausgeführt: die Installation mit Docker Compose und PostgreSQL, HTTPS, das erste Konto, die API-Schlüssel der einzelnen Medientypen, Backups und Updates.
Von Simon Vasconcelos Lee
Veröffentlicht am 19. November 2026Lesezeit: 11 Minuten
ignisda/ryot und PostgreSQL 18, mit dem Port 8000 auf 127.0.0.1 veröffentlicht, hinter einem Reverse Proxy mit HTTPS.SERVER_ADMIN_ACCESS_TOKEN in einer Datei .env ab, und setzen Sie FRONTEND_URL auf Ihre öffentliche Adresse.USERS_ALLOW_REGISTRATION=false, um die Registrierung auf einer privaten Instanz zu schließen.pg_dump und aktualisieren Sie dann, indem Sie das Image-Tag ändern.Ryot, für „Roll Your Own Tracker“ und „riot“ ausgesprochen, hält an einem Ort fest, was Sie gesehen, gelesen, gespielt und trainiert haben, mit Statistiken, einem Kalender der kommenden Erscheinungen und eigenen Sammlungen. Sein Entwickler, IgnisDa, schreibt es in Rust, mit einer Weboberfläche, die Sie auf einem Telefon als App installieren können.
Ryot wird unter der GNU General Public License, Version 3 (GPL-3.0) veröffentlicht. Sie können es kostenlos nutzen, für sich, Ihre Familie, Ihren Verein oder Ihr Unternehmen, es kopieren und ändern. Wenn Sie eine geänderte Fassung verbreiten, verbreiten Sie ihren Quellcode unter derselben Lizenz. Die Software wird ohne Gewährleistung bereitgestellt.
Ryot Pro ist ein kostenpflichtiger Schlüssel, den sein Entwickler verkauft und der zusätzliche Funktionen freischaltet, etwa das Teilen von Profilen und persönliche Empfehlungen. Er kommt in eine Variable SERVER_PRO_KEY desselben Images, und der Server kehrt zur Community-Version zurück, wenn der Schlüssel abläuft. Nichts in diesem Leitfaden braucht ihn.
Die Dokumentation nennt keine Mindestgröße, und Ryot ist leichtgewichtig. Das haben wir auf unserem frisch installierten Test-VPS gemessen:
Die Größe des Servers hängt also von der Zahl der Nutzer und von den anderen Anwendungen ab, die Sie neben Ryot betreiben. Auf einem Managed VPS beschreiben Sie uns Ihre Nutzung, und wir empfehlen Ihnen die passende Größe.
Ryot wird als ein einziges Image ausgeliefert, ignisda/ryot, auch als ghcr.io/ignisda/ryot veröffentlicht, das sowohl die Oberfläche als auch die API auf Port 8000 bereitstellt. Es braucht PostgreSQL 15 oder neuer, daneben in einem eigenen Container betrieben. Legen Sie auf einem Server mit Docker Engine und seinem Compose-Plugin, installiert aus dem Docker-Repository für Ubuntu, einen Ordner wie /opt/ryot an und speichern Sie darin diese compose.yaml, die auf der Datei der Installationsseite aufbaut:
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:
Die beiden Geheimnisse kommen in eine Datei .env daneben, die Docker Compose von selbst liest. Legen Sie sie so an, dass nur root sie lesen kann, und starten Sie dann den 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 veröffentlicht: Die Referenzdatei veröffentlicht ihn ohne Adresse, und Docker öffnet ihn dann auf allen Adressen des Servers. Lokal veröffentlicht, ist er nur über den Reverse Proxy erreichbar.postgres als Benutzer und Passwort. Hier erhält ein eigener Benutzer ryot ein zufälliges Passwort, hexadezimal, damit es in DATABASE_URL kein Escaping braucht.SERVER_ADMIN_ACCESS_TOKEN ist Pflicht: Es berechtigt Administratorvorgänge über die API und verschlüsselt die Geheimnisse der Zwei-Faktor-Authentifizierung Ihrer Nutzer. Halten Sie es geheim und lassen Sie es unverändert: Mit einem anderen Token lassen sich diese Geheimnisse nicht mehr lesen.FRONTEND_URL ist Ihre öffentliche Adresse, mit https://. Ryot verwendet sie als Basis der Links, die es erzeugt, und OpenID Connect braucht sie.TZ ist die Zeitzone der geplanten Aufgaben, standardmäßig GMT: Tragen Sie Ihre ein, aus der IANA-Liste.v10 mit pull_policy: always vor, was bei jedem Start jeder Nebenversion folgt. Mit einer vollständigen Versionsnummer, hier v10.5.8, bestimmen Sie selbst, wann jedes Update kommt.postgres_storage enthält alle Ihre Daten. PostgreSQL 18 legt sie unter /var/lib/postgresql ab, deshalb wird das Volume dort eingebunden und nicht auf /var/lib/postgresql/data wie bei älteren Versionen.Der erste Start führt die Migrationen der Datenbank aus und lädt den Übungskatalog herunter; auf unserem Test-VPS antwortete Ryot nach wenigen Sekunden. Um zu prüfen, ob es antwortet:
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
Der erste Befehl antwortet 200. Der zweite gibt die Konfiguration zurück, die der Server geladen hat, als JSON, mit geschwärzten Geheimnissen: ein praktischer Weg, eine Variable zu prüfen.
Der Container liefert Ryot über HTTP aus, auf Port 8000. HTTPS übernimmt ein vorgeschalteter Reverse Proxy, der den öffentlichen Header Host und X-Forwarded-Proto weiterleiten muss. Wir haben Caddy getestet, installiert aus seinem offiziellen Repository für Debian und Ubuntu: Es bezieht das Zertifikat von Let’s Encrypt selbst, erneuert es und leitet diese Header standardmäßig weiter.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.Ryot hat kein Standardkonto, und auf einer neuen Instanz ist die Registrierung offen. Das erste Konto, das angelegt wird, erhält die Rolle Admin; die folgenden sind normale Nutzer. Legen Sie Ihres gleich nach dem ersten Start an:
Schließen Sie für eine private Instanz die Registrierung: Ergänzen Sie USERS_ALLOW_REGISTRATION=false in der Umgebung des Dienstes ryot und führen Sie dann docker compose up -d aus. Auf unserem Test-VPS verschwand der Link „Create a new account?“, und eine über die Registrierungsadresse versuchte Anmeldung wies der Server mit „Registration is disabled“ ab.
Wir haben es bei geschlossener Registrierung getestet: Das eingeladene Konto wurde als normaler Nutzer angelegt, sein Passwort über den Link gesetzt, und es erreichte sein eigenes Dashboard.
Um sich stattdessen mit den Konten Ihres Unternehmens anzumelden, unterstützt Ryot OpenID Connect: Setzen Sie SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET und SERVER_OIDC_ISSUER_URL, und hinterlegen Sie bei Ihrem Anbieter https://ryot.example.com/api/auth als Weiterleitungsadresse.
Ryot findet die Details und Cover jedes Medientyps bei einem Anbieter. Manche funktionieren ohne Schlüssel, andere brauchen Ihren eigenen, da die gemeinsamen Schlüssel in v9 entfernt wurden:
| Medium | Anbieter | Was einzutragen ist |
|---|---|---|
| Bücher | Open Library | Nichts: Es funktioniert sofort. Google Books und Hardcover sind optional, mit ihrem API-Schlüssel |
| Filme und Serien | TMDB oder TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, das API Read Access Token eines kostenlosen TMDB-Kontos, oder MOVIES_AND_SHOWS_TVDB_API_KEY |
| Videospiele | IGDB, über Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID und VIDEO_GAMES_TWITCH_CLIENT_SECRET, aus einer Anwendung in der Entwicklerkonsole von Twitch |
| Musik | Spotify, optional | MUSIC_SPOTIFY_CLIENT_ID und MUSIC_SPOTIFY_CLIENT_SECRET |
| Anime-Import | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, nur nötig, um aus MyAnimeList zu importieren |
Diese Schlüssel sind Geheimnisse: Legen Sie sie in der Datei .env ab, ergänzen Sie eine Zeile wie - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} in der Umgebung des Dienstes ryot und führen Sie dann docker compose up -d aus. Die Konfigurationsseite der Dokumentation listet alle weiteren Variablen auf.
Alles liegt an zwei Stellen: in der PostgreSQL-Datenbank, im Volume postgres_storage, und in Ihrer Datei .env. Bewahren Sie Letztere sicher auf: SERVER_ADMIN_ACCESS_TOKEN wird gebraucht, um die in der Datenbank gespeicherten Zwei-Faktor-Geheimnisse zu lesen. Das PostgreSQL-Image enthält pg_dump. Der Dump enthält jedes Konto und seinen Verlauf; legen Sie ihn also so an, dass nur root ihn lesen kann, mit umask 077 in Klammern: Der Rest Ihrer Sitzung behält seine übliche Maske. Eine bereits vorhandene Datei behält ihre Rechte, wenn sie überschrieben wird; deshalb schließt die Zeile find zuerst die Dumps und Kopien, die schon im Ordner liegen, bevor irgendetwas geschrieben wird, und bricht das Backup ab, wenn ihr das nicht gelingt:
(
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
)
Planen Sie diese Kopie regelmäßig ein und senden Sie sie außerhalb des Servers. Auf der Festplatte abgelegt, gehen die Dumps außerdem in die nächtlichen Backups des Servers ein.
Halten Sie auf derselben oder einer neuen Installation, mit derselben .env, die Anwendung an, ersetzen Sie die Datenbank durch eine leere, spielen Sie den Dump darin ein und starten Sie die Anwendung dann wieder:
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 hält die Wiederherstellung beim ersten Fehler an, statt weiterzumachen und die Fehler am Ende zu melden, und die && beenden die Abfolge an dieser Stelle: Ryot bleibt angehalten. Was vor dem Fehler geladen wurde, bleibt in der Datenbank; beginnen Sie also wieder bei dropdb, sobald die Ursache behoben ist.Wir haben den ganzen Ablauf auf unserem VPS mit genau diesen Befehlen getestet: Dump, die Datenbank gelöscht und leer neu angelegt, Wiederherstellung. Die beiden Konten, ihre Sammlungen und die 876 Übungen waren wieder da, und der Administrator konnte sich sofort wieder anmelden.
Ryot exportiert Ihre eigenen Daten außerdem als JSON, über die Einstellungsseite „Imports and Exports“, und kann sie wieder importieren. Dieser Export braucht einen S3-kompatiblen Dateispeicher; der Datenbank-Dump oben funktioniert ohne ihn.
Ryot erscheint häufig, ungefähr im Wochentakt. Lesen Sie die Release Notes, erstellen Sie ein Backup, ändern Sie das Image-Tag in der compose.yaml, laden Sie dann das neue Image und erstellen Sie den Container neu. Die Migrationen der Datenbank laufen beim Start von selbst:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop folgt dem Hauptzweig: Die Dokumentation warnt, dass es oft schwere Fehler enthält und Daten verlieren kann. Bleiben Sie bei den veröffentlichten Versionen.Ryot erfasst anonyme Nutzungsdaten, Seitenaufrufe und einige Ereignisse, auf einer selbst gehosteten Umami-Instanz seines Entwicklers. Um sie abzuschalten, ergänzen Sie DISABLE_TELEMETRY=true in der Umgebung des Dienstes ryot und führen Sie dann docker compose up -d aus.
Beim Selbsthosting müssen Sie neben der Anwendung auch den Server betreuen. Auf einem Managed VPS übernehmen unsere Teams den Server und betreuen Ihre Instanz proaktiv; Ryot bleibt Ihre Software, mit Ihrem Verlauf und Ihren Einstellungen.
| Thema | Unsere Teams | Sie |
|---|---|---|
| Der Server | System- und Sicherheitsupdates, Eingriffe am Server inbegriffen | Der Zeitpunkt, der Ihnen passt |
| Die Überwachung | Server rund um die Uhr im Blick, mit Eingriff, ohne auf Ihren Anruf zu warten | Ihr Verlauf, Ihre Sammlungen und Ihre Integrationen in Ryot |
| Ryot | Proaktive Betreuung: Fehler, lange Antwortzeiten, Datenbank und Speicherplatz erkannt, Korrektur empfohlen | Installation, Updates, API-Schlüssel und Einstellungen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten |
| Die Nutzer | Der Server, der sie trägt, überwacht und gesichert | Die Konten, die Registrierung und das Single Sign-on |
| Die Backups | Jede Nacht, verschlüsselt und außerhalb der Maschine aufbewahrt; Wiederherstellung inbegriffen | Die eigenen Datenbank-Dumps und JSON-Exporte von Ryot und die Wiederherstellungsanfrage, wenn Sie sie brauchen |
| Die Migration | Ihr aktueller Server wird kostenlos migriert | Der Zeitpunkt der Umstellung |
Wenn unsere Teams lieber in der Anwendung selbst eingreifen sollen, wird diese Leistung nach Stunden oder pauschal abgerechnet, mit einem Kostenvoranschlag vor dem Eingriff.
Mit einem Managed VPS von Simafri halten unsere Teams den Server Ihrer Ryot-Instanz aktuell, überwachen ihn Tag und Nacht und greifen ein, ohne auf Ihren Anruf zu warten; sie betreuen auch Ihre Instanz proaktiv und empfehlen Ihnen die sinnvollen Korrekturen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten. Die Backups werden jede Nacht verschlüsselt und außerhalb der Maschine aufbewahrt, ihre Wiederherstellung ist inbegriffen, und die Migration Ihres aktuellen Servers ist kostenlos.
Ja. Ryot steht unter der GPL-3.0-Lizenz: Sie können es für sich, Ihre Familie oder Ihr Team betreiben, ohne eine Lizenz zu kaufen. Ryot Pro ist ein optionaler kostenpflichtiger Schlüssel, der demselben Image Funktionen hinzufügt. Bleiben die Kosten für den Server, auf dem es läuft.
Verwenden Sie das Image ignisda/ryot und PostgreSQL 18 in einer compose.yaml. Legen Sie das Datenbankpasswort und SERVER_ADMIN_ACCESS_TOKEN in einer Datei .env ab, setzen Sie FRONTEND_URL auf Ihre https-Adresse, veröffentlichen Sie den Port 8000 auf 127.0.0.1, starten Sie docker compose up -d und schalten Sie einen Reverse Proxy mit HTTPS davor.
Es gibt keine. Klicken Sie auf der Anmeldeseite auf „Create a new account?“: Das erste angelegte Konto wird Administrator. Setzen Sie danach USERS_ALLOW_REGISTRATION=false, um die Registrierung zu schließen; der Administrator lädt die anderen Nutzer unter Settings, Users ein, mit einem Link zur einmaligen Verwendung.
Seit v9 brauchen Filme und Serien Ihr eigenes TMDB-Token: Legen Sie ein kostenloses TMDB-Konto an, beantragen Sie einen API-Schlüssel und tragen Sie sein API Read Access Token in MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN ein. Videospiele brauchen eine Twitch-Anwendung, während Bücher ganz ohne Schlüssel funktionieren.
Wenig. Auf unserem Test-VPS belegte eine frische Installation etwa 240 bis 300 MB für Ryot und 70 MB für PostgreSQL, und die beiden Images belegen etwa 810 MB auf der Festplatte.
Erstellen Sie einen Dump der PostgreSQL-Datenbank mit docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot unter umask 077, damit nur root ihn lesen kann, und bewahren Sie eine Kopie Ihrer Datei .env auf. Halten Sie zum Wiederherstellen die Anwendung an, legen Sie die Datenbank mit dropdb und createdb leer neu an und spielen Sie den Dump dann mit pg_restore --exit-on-error --no-owner ein.
Lesen Sie die Release Notes und erstellen Sie ein Backup, ändern Sie das Image-Tag in der compose.yaml und führen Sie dann docker compose pull und docker compose up -d aus. Die Migrationen der Datenbank laufen beim Start von selbst. Folgen Sie zwischen Hauptversionen der Migrationsseite.
Ein Managed VPS deckt den Server ab: System, Sicherheit, Überwachung und Backups. Unsere Teams betreuen auch Ihre Instanz proaktiv und empfehlen Ihnen die sinnvollen Korrekturen, die Sie umsetzen. Ein Eingriff in der Anwendung wird nach Stunden oder pauschal abgerechnet.
Simafri
Sprechen wir über Ihr Vorhaben
Sagen Sie uns in wenigen Worten, was Sie brauchen: Wir melden uns schnell bei Ihnen.
Vielen Dank! Ihre Anfrage wurde gesendet. Wir melden uns in Kürze bei Ihnen.
Sie schreiben lieber eine E-Mail? Schreiben Sie uns an support@simafri.com.