Ryot auf einem Managed VPS hosten: Ihr Tracker für Medien und Training

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.

Simon Vasconcelos Lee Von Veröffentlicht am 19. November 2026Lesezeit: 11 Minuten

Alle Leitfäden

Das Wichtigste in Kürze

  1. Die GPL-3.0-Lizenz erlaubt es, Ryot für sich, Ihre Familie oder Ihren Verein zu betreiben, ohne eine Lizenz zu kaufen; Ryot Pro, ein kostenpflichtiger Schlüssel, ergänzt Funktionen auf demselben Image.
  2. Installieren Sie es mit Docker Compose: das Image ignisda/ryot und PostgreSQL 18, mit dem Port 8000 auf 127.0.0.1 veröffentlicht, hinter einem Reverse Proxy mit HTTPS.
  3. Legen Sie das Datenbankpasswort und SERVER_ADMIN_ACCESS_TOKEN in einer Datei .env ab, und setzen Sie FRONTEND_URL auf Ihre öffentliche Adresse.
  4. Das erste Konto, das Sie anlegen, wird Administrator; setzen Sie danach USERS_ALLOW_REGISTRATION=false, um die Registrierung auf einer privaten Instanz zu schließen.
  5. Bücher funktionieren sofort; Filme und Serien brauchen ein TMDB-Token, Videospiele eine Twitch-Anwendung. Sichern Sie mit pg_dump und aktualisieren Sie dann, indem Sie das Image-Tag ändern.

Was Ryot kann

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.

Was die GPL-3.0-Lizenz erlaubt

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 einzuplanenden Ressourcen

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.

Die Installation mit Docker Compose

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:

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:

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:

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

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:

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

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.

HTTPS: der Reverse Proxy

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.

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

Das erste Konto, die Registrierung und die Einladungen

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:

  1. Öffnen Sie Ihre Adresse: Ryot zeigt seine Anmeldeseite.
  2. Klicken Sie auf „Create a new account?“ und geben Sie dann einen Benutzernamen und zweimal ein Passwort ein.
  3. Registrieren Sie sich und melden Sie sich dann mit Ihren neuen Zugangsdaten an: Sie landen auf dem Dashboard, mit einer Einführungstour.
  4. Unter „Settings“, „Users“ erscheint Ihr Konto mit der Rolle Admin.

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.

Die anderen Nutzer einladen

  1. Klicken Sie unter „Settings“, „Users“ auf die Schaltfläche + neben dem Titel.
  2. Geben Sie den Benutzernamen der Person ein: Ryot legt das Konto an und zeigt einen Link zur einmaligen Verwendung.
  3. Senden Sie den Link: Die Person öffnet ihn, wählt ein Passwort und meldet sich dann an.

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.

Filme, Serien und Spiele: die API-Schlüssel

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:

MediumAnbieterWas einzutragen ist
BücherOpen LibraryNichts: Es funktioniert sofort. Google Books und Hardcover sind optional, mit ihrem API-Schlüssel
Filme und SerienTMDB oder TVDBMOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, das API Read Access Token eines kostenlosen TMDB-Kontos, oder MOVIES_AND_SHOWS_TVDB_API_KEY
VideospieleIGDB, über TwitchVIDEO_GAMES_TWITCH_CLIENT_ID und VIDEO_GAMES_TWITCH_CLIENT_SECRET, aus einer Anwendung in der Entwicklerkonsole von Twitch
MusikSpotify, optionalMUSIC_SPOTIFY_CLIENT_ID und MUSIC_SPOTIFY_CLIENT_SECRET
Anime-ImportMyAnimeListANIME_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.

Die Backups

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:

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
)

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.

Die Wiederherstellung

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:

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

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.

Die Updates

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:

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

Die Telemetrie

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.

Wer was tut auf einem Managed VPS

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.

ThemaUnsere TeamsSie
Der ServerSystem- und Sicherheitsupdates, Eingriffe am Server inbegriffenDer Zeitpunkt, der Ihnen passt
Die ÜberwachungServer rund um die Uhr im Blick, mit Eingriff, ohne auf Ihren Anruf zu wartenIhr Verlauf, Ihre Sammlungen und Ihre Integrationen in Ryot
RyotProaktive Betreuung: Fehler, lange Antwortzeiten, Datenbank und Speicherplatz erkannt, Korrektur empfohlenInstallation, Updates, API-Schlüssel und Einstellungen, die Sie umsetzen, selbst oder mit Ihrem KI-Assistenten
Die NutzerDer Server, der sie trägt, überwacht und gesichertDie Konten, die Registrierung und das Single Sign-on
Die BackupsJede Nacht, verschlüsselt und außerhalb der Maschine aufbewahrt; Wiederherstellung inbegriffenDie eigenen Datenbank-Dumps und JSON-Exporte von Ryot und die Wiederherstellungsanfrage, wenn Sie sie brauchen
Die MigrationIhr aktueller Server wird kostenlos migriertDer 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.

Ryot auf einem Server, der für Sie gepflegt wird

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.

Managed VPS entdecken

Häufige Fragen

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

Wie installiere ich Ryot mit Docker Compose?

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.

Wie lauten die Standardzugangsdaten von Ryot?

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.

Warum findet Ryot keine Filme oder Serien?

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.

Wie viel Arbeitsspeicher braucht Ryot?

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.

Wie sichere ich Ryot?

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.

Wie aktualisiere ich Ryot?

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.

Deckt ein Managed VPS Ryot ab?

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.

Verwandte Leitfäden

PostgreSQL auf einem VPS: Arbeitsspeicher und Festplatte bemessenEine schnelle PostgreSQL-Datenbank ist eine Datenbank, deren häufig gelesene Daten in den Arbeitsspeicher passen. Die gesamte Dimensionierung geht davon aus: das Volumen der Datenbank, der Teil, der wirklich arbeitet, die Zahl der Verbindungen, dann die Festplatte und ihre Reserve. Dieser Leitfaden gibt Ihnen die Methode, die Starteinstellungen für 4, 8 und 16 GB Arbeitsspeicher und die Abfragen, die eine bestehende Datenbank vermessen.VPS-Backups: was Sie vor Vertragsabschluss prüfen solltenEin VPS-Angebot verspricht fast immer „Backups inklusive“. Hinter diesen zwei Wörtern kann eine Kopie jede Nacht stehen, außerhalb der Maschine aufbewahrt und von Experten wiederhergestellt, oder ein Snapshot auf derselben Festplatte wie der Server. Dieser Leitfaden nennt die Fragen, die den Unterschied machen, erklärt, was jede Antwort bedeutet, und zeigt, wie Sie prüfen, dass sich ein Backup wiederherstellen lässt.Actual Budget auf einem Managed VPS hosten: Ihre Budgets auf Ihrem ServerActual Budget auf einem Managed VPS zu hosten heißt, Ihre Budgets und ihre Synchronisierung auf einer Maschine zu bewahren, die Ihnen gehört und die unsere Teams aktuell halten und Tag und Nacht beaufsichtigen. Actual Budget ist ein Local-first-Werkzeug für persönliche Finanzen, veröffentlicht unter der MIT-Lizenz. Dieser Leitfaden folgt der offiziellen Dokumentation: die Rolle des Servers, die Installation mit Docker Compose, HTTPS, das Serverpasswort, OpenID, die Ende-zu-Ende-Verschlüsselung, die Bank-Synchronisierung, Backups und Updates.
Kontaktieren Sie uns