Hosting Ryot na Managed VPS: Państwa tracker mediów i treningów

Hosting Ryot na Managed VPS oznacza, że historia tego, co Państwo oglądają, czytają, w co grają i co podnoszą na siłowni, pozostaje na serwerze, który należy do Państwa, a nasze zespoły dbają o jego aktualność i nadzorują go dniem i nocą. Ryot to wolny, otwartoźródłowy tracker na licencji GPL-3.0, dla filmów, seriali, książek, gier, podcastów, muzyki i treningów. Ten poradnik podąża za jego oficjalnym obrazem Docker w wersji v10.5.8, a każde polecenie uruchomiliśmy na VPS Simafri przed napisaniem poradnika: instalacja przez Docker Compose i PostgreSQL, HTTPS, pierwsze konto, klucze API dla każdego typu mediów, kopie zapasowe i aktualizacje.

Simon Vasconcelos Lee Autor: Opublikowano 19 listopada 2026Czas czytania: 11 minut

Wszystkie poradniki

W skrócie

  1. Licencja GPL-3.0 pozwala uruchamiać Ryot dla siebie, swojej rodziny lub klubu bez zakupu licencji; Ryot Pro, płatny klucz, dodaje funkcje na tym samym obrazie.
  2. Proszę zainstalować go przez Docker Compose: obraz ignisda/ryot i PostgreSQL 18, z portem 8000 opublikowanym na 127.0.0.1 za odwrotnym proxy z HTTPS.
  3. Proszę umieścić hasło bazy danych i SERVER_ADMIN_ACCESS_TOKEN w pliku .env i ustawić FRONTEND_URL na swój publiczny adres.
  4. Pierwsze utworzone konto zostaje administratorem; następnie proszę ustawić USERS_ALLOW_REGISTRATION=false, aby zamknąć rejestrację na prywatnej instancji.
  5. Książki działają od razu; filmy i seriale wymagają tokenu TMDB, gry wideo aplikacji Twitch. Kopię zapasową wykonuje się przez pg_dump, a aktualizuje przez zmianę tagu obrazu.

Co robi Ryot

Ryot, od „Roll Your Own Tracker”, wymawiany jak „riot”, przechowuje w jednym miejscu to, co Państwo obejrzeli, przeczytali, w co grali i co trenowali, ze statystykami, kalendarzem tego, co nadchodzi, i własnymi kolekcjami. Jego twórca, IgnisDa, pisze go w Ruście, z interfejsem webowym, który można zainstalować na telefonie jako aplikację.

Na co pozwala licencja GPL-3.0

Ryot jest udostępniany na licencji GNU General Public License, wersja 3 (GPL-3.0). Mogą Państwo używać go bezpłatnie, dla siebie, swojej rodziny, klubu lub firmy, kopiować go i modyfikować. Jeśli rozpowszechniają Państwo zmodyfikowaną wersję, rozpowszechniają Państwo jej kod źródłowy na tej samej licencji. Oprogramowanie jest dostarczane bez gwarancji.

Ryot Pro to płatny klucz sprzedawany przez twórcę, który odblokowuje dodatkowe funkcje, takie jak udostępnianie profilu i spersonalizowane rekomendacje. Umieszcza się go w zmiennej SERVER_PRO_KEY tego samego obrazu, a gdy klucz wygaśnie, serwer wraca do wersji społecznościowej. Nic w tym poradniku go nie wymaga.

Zasoby do zaplanowania

Dokumentacja nie podaje minimalnego rozmiaru, a Ryot jest lekki. Oto, co zmierzyliśmy na naszym testowym VPS, świeżo po instalacji:

Rozmiar serwera zależy więc od liczby użytkowników i od innych aplikacji, które uruchamiają Państwo obok Ryot. Na Managed VPS wystarczy opisać nam swoje zastosowanie, a polecimy odpowiedni rozmiar.

Instalacja przez Docker Compose

Ryot jest dostarczany jako jeden obraz, ignisda/ryot, publikowany też jako ghcr.io/ignisda/ryot, który obsługuje zarówno interfejs, jak i API na porcie 8000. Wymaga PostgreSQL 15 lub nowszego, uruchomionego obok we własnym kontenerze. Na serwerze z Docker Engine i jego wtyczką Compose, zainstalowanymi z repozytorium Dockera dla Ubuntu, proszę utworzyć katalog, na przykład /opt/ryot, i umieścić w nim ten compose.yaml, oparty na pliku ze strony instalacji:

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:

Oba sekrety trafiają do pliku .env obok, który Docker Compose odczytuje sam. Proszę utworzyć go z prawem odczytu wyłącznie dla roota, a następnie uruchomić stos:

Terminal, w /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

Pierwsze uruchomienie wykonuje migracje bazy danych i pobiera katalog ćwiczeń; na naszym testowym VPS Ryot odpowiedział po kilku sekundach. Aby sprawdzić, czy odpowiada:

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

Pierwsze polecenie odpowiada 200. Drugie zwraca konfigurację wczytaną przez serwer, w formacie JSON, z ukrytymi sekretami: wygodny sposób na sprawdzenie zmiennej.

HTTPS: odwrotne proxy

Kontener udostępnia Ryot przez HTTP, na porcie 8000. HTTPS obsługuje odwrotne proxy umieszczone przed nim, które musi przekazywać publiczny nagłówek Host oraz X-Forwarded-Proto. Przetestowaliśmy Caddy, zainstalowany z jego oficjalnego repozytorium dla Debiana i Ubuntu: sam uzyskuje certyfikat Let’s Encrypt, odnawia go i domyślnie przekazuje te nagłówki.

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

Pierwsze konto, rejestracja i zaproszenia

Ryot nie ma konta domyślnego, a na nowej instancji rejestracja jest otwarta. Pierwsze konto otrzymuje rolę Admin; kolejne to zwykli użytkownicy. Proszę utworzyć swoje zaraz po pierwszym uruchomieniu:

  1. Proszę otworzyć swój adres: Ryot wyświetla stronę logowania.
  2. Proszę kliknąć „Create a new account?”, a następnie podać nazwę użytkownika i dwukrotnie hasło.
  3. Proszę się zarejestrować, a potem zalogować nowymi danymi: trafiają Państwo na pulpit, z samouczkiem wprowadzającym.
  4. W „Settings”, „Users” Państwa konto widnieje z rolą Admin.

Dla prywatnej instancji proszę zamknąć rejestrację: dodać USERS_ALLOW_REGISTRATION=false do środowiska usługi ryot, a następnie uruchomić docker compose up -d. Na naszym testowym VPS link „Create a new account?” zniknął, a próbę rejestracji z adresu rejestracji serwer odrzucił komunikatem „Registration is disabled”.

Zapraszanie pozostałych użytkowników

  1. W „Settings”, „Users” proszę kliknąć przycisk + obok tytułu.
  2. Proszę podać nazwę użytkownika tej osoby: Ryot tworzy konto i wyświetla jednorazowy link.
  3. Proszę wysłać link: osoba otwiera go, wybiera hasło, a potem się loguje.

Przetestowaliśmy to przy zamkniętej rejestracji: zaproszone konto zostało utworzone jako zwykły użytkownik, jego hasło ustawiono z linku i trafiło ono na własny pulpit.

Aby zamiast tego logować się kontami firmowymi, Ryot obsługuje OpenID Connect: proszę ustawić SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET i SERVER_OIDC_ISSUER_URL oraz zadeklarować u swojego dostawcy https://ryot.example.com/api/auth jako adres przekierowania.

Filmy, seriale i gry: klucze API

Ryot pobiera szczegóły i okładki każdego typu mediów od dostawcy. Niektórzy działają bez klucza, inni wymagają Państwa własnego, ponieważ wspólne klucze zostały usunięte w v9:

MediaDostawcaCo ustawić
KsiążkiOpen LibraryNic: działa od razu. Google Books i Hardcover są opcjonalne, z ich kluczem API
Filmy i serialeTMDB lub TVDBMOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, API Read Access Token bezpłatnego konta TMDB, albo MOVIES_AND_SHOWS_TVDB_API_KEY
Gry wideoIGDB, przez TwitchVIDEO_GAMES_TWITCH_CLIENT_ID i VIDEO_GAMES_TWITCH_CLIENT_SECRET, z aplikacji w konsoli deweloperskiej Twitch
MuzykaSpotify, opcjonalnieMUSIC_SPOTIFY_CLIENT_ID i MUSIC_SPOTIFY_CLIENT_SECRET
Import animeMyAnimeListANIME_AND_MANGA_MAL_CLIENT_ID, potrzebny tylko do importu z MyAnimeList

Te klucze są sekretami: proszę umieścić je w pliku .env, dodać wiersz taki jak - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} do środowiska usługi ryot, a następnie uruchomić docker compose up -d. Strona konfiguracji w dokumentacji wymienia wszystkie pozostałe zmienne.

Kopie zapasowe

Wszystko znajduje się w dwóch miejscach: w bazie PostgreSQL, w wolumenie postgres_storage, oraz w Państwa pliku .env. Ten drugi proszę przechowywać w bezpiecznym miejscu: SERVER_ADMIN_ACCESS_TOKEN jest potrzebny do odczytu sekretów dwuskładnikowych zapisanych w bazie. Obraz PostgreSQL zawiera pg_dump. Zrzut zawiera wszystkie konta i ich historię, dlatego proszę tworzyć go z prawem odczytu wyłącznie dla roota, z umask 077 w nawiasach: reszta Państwa sesji zachowuje swoją zwykłą maskę. Plik, który już istnieje, zachowuje swoje uprawnienia przy nadpisaniu, dlatego wiersz find najpierw zamyka dostęp do zrzutów i kopii znajdujących się już w katalogu, zanim cokolwiek zostanie zapisane, i przerywa kopię zapasową, jeśli mu się to nie uda:

Terminal, w /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
)

Proszę zaplanować tę kopię i wysyłać ją poza serwer. Umieszczone na dysku, zrzuty trafiają także do nocnych kopii zapasowych serwera.

Przywracanie

Na tej samej lub nowej instalacji, z tym samym .env, proszę zatrzymać aplikację, zastąpić bazę danych pustą, wczytać do niej zrzut, a następnie ponownie uruchomić aplikację:

Terminal, w /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

Przetestowaliśmy cały cykl na naszym VPS dokładnie tymi poleceniami: zrzut, usunięcie bazy danych i ponowne utworzenie jej pustej, przywrócenie. Oba konta, ich kolekcje i 876 ćwiczeń wróciły, a administrator od razu znów się zalogował.

Ryot eksportuje też Państwa własne dane do JSON, ze strony ustawień „Imports and Exports”, i potrafi je z powrotem zaimportować. Ten eksport wymaga magazynu plików zgodnego z S3; powyższy zrzut bazy danych działa bez niego.

Aktualizacje

Ryot ukazuje się często, mniej więcej co tydzień. Proszę przeczytać informacje o wydaniu, wykonać kopię zapasową, zmienić tag obrazu w compose.yaml, a następnie pobrać nowy obraz i odtworzyć kontener. Migracje bazy danych uruchamiają się same przy starcie:

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

Telemetria

Ryot zbiera anonimowe dane o użyciu, odsłony stron i kilka zdarzeń, na samodzielnie hostowanej instancji Umami swojego twórcy. Aby to wyłączyć, proszę dodać DISABLE_TELEMETRY=true do środowiska usługi ryot, a następnie uruchomić docker compose up -d.

Kto za co odpowiada na Managed VPS

Samodzielny hosting wymaga prowadzenia serwera, oprócz samej aplikacji. Na Managed VPS nasze zespoły przejmują serwer i proaktywnie czuwają nad Państwa instancją; Ryot pozostaje Państwa oprogramowaniem, z Państwa historią i ustawieniami.

TematNasze zespołyPaństwo
SerwerAktualizacje systemu i zabezpieczeń, w tym interwencje na serwerzeMoment dogodny dla Państwa
NadzórSerwer pod opieką całą dobę, 7 dni w tygodniu, z interwencją bez czekania na Państwa telefonPaństwa historia, kolekcje i integracje w Ryot
RyotProaktywna opieka: wychwytujemy błędy, spowolnienia, stan bazy danych i brak miejsca na dysku oraz polecamy poprawkęInstalacja, aktualizacje, klucze API i ustawienia, które wdrażają Państwo sami albo Państwa asystent AI
UżytkownicySerwer, który ich obsługuje, nadzorowany i objęty kopiami zapasowymiKonta, rejestracja i logowanie jednokrotne
Kopie zapasoweCo noc, szyfrowane i przechowywane poza maszyną; przywracanie w cenieZrzuty bazy danych i eksporty JSON właściwe dla Ryot oraz zgłoszenie prośby o przywrócenie, gdy będzie potrzebne
MigracjaMigracja Państwa obecnego serwera, bezpłatnaMoment przełączenia

Jeśli wolą Państwo, aby nasze zespoły interweniowały w samej aplikacji, usługa ta jest rozliczana godzinowo lub ryczałtowo, z wyceną przekazaną przed interwencją.

Ryot na serwerze prowadzonym za Państwa

Z Managed VPS od Simafri nasze zespoły utrzymują serwer Państwa instancji Ryot w aktualności, nadzorują go dniem i nocą i interweniują bez czekania na Państwa telefon; proaktywnie czuwają także nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami albo Państwa asystent AI. Kopie zapasowe są szyfrowane co noc i przechowywane poza maszyną, ich przywracanie jest w cenie, a migracja obecnego serwera jest bezpłatna.

Poznaj Managed VPS

Częste pytania

Czy Ryot jest bezpłatny?

Tak. Ryot jest udostępniany na licencji GPL-3.0: mogą Państwo uruchamiać go dla siebie, swojej rodziny lub zespołu bez zakupu licencji. Ryot Pro to opcjonalny płatny klucz, który dodaje funkcje do tego samego obrazu. Pozostaje koszt serwera, na którym działa.

Jak zainstalować Ryot przez Docker Compose?

Proszę użyć obrazu ignisda/ryot i PostgreSQL 18 w pliku compose.yaml. Proszę umieścić hasło bazy danych i SERVER_ADMIN_ACCESS_TOKEN w pliku .env, ustawić FRONTEND_URL na swój adres https, opublikować port 8000 na 127.0.0.1, uruchomić docker compose up -d i postawić przed nim odwrotne proxy z HTTPS.

Jakie są domyślne dane logowania Ryot?

Takich danych nie ma. Proszę kliknąć „Create a new account?” na stronie logowania: pierwsze utworzone konto zostaje administratorem. Następnie proszę ustawić USERS_ALLOW_REGISTRATION=false, aby zamknąć rejestrację; administrator zaprasza pozostałych użytkowników z Settings, Users, jednorazowym linkiem.

Dlaczego Ryot nie znajduje filmów ani seriali?

Od v9 filmy i seriale wymagają Państwa własnego tokenu TMDB: proszę założyć bezpłatne konto TMDB, poprosić o klucz API i wpisać jego API Read Access Token w MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Gry wideo wymagają aplikacji Twitch, a książki działają bez żadnego klucza.

Ile pamięci potrzebuje Ryot?

Niewiele. Na naszym testowym VPS świeża instalacja zużywała około 240 do 300 MB dla Ryot i 70 MB dla PostgreSQL, a oba obrazy zajmują około 810 MB na dysku.

Jak wykonać kopię zapasową Ryot?

Proszę wykonać zrzut bazy PostgreSQL poleceniem docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot pod umask 077, aby tylko root mógł go odczytać, i zachować kopię pliku .env. Aby przywrócić, proszę zatrzymać aplikację, odtworzyć pustą bazę poleceniami dropdb i createdb, a następnie wczytać zrzut poleceniem pg_restore --exit-on-error --no-owner.

Jak zaktualizować Ryot?

Proszę przeczytać informacje o wydaniu i wykonać kopię zapasową, zmienić tag obrazu w compose.yaml, a następnie uruchomić docker compose pull i docker compose up -d. Migracje bazy danych uruchamiają się same przy starcie. Między wersjami głównymi proszę postępować zgodnie ze stroną migracji.

Czy Managed VPS obejmuje Ryot?

Managed VPS obejmuje serwer: system, bezpieczeństwo, nadzór i kopie zapasowe. Nasze zespoły proaktywnie czuwają też nad Państwa instancją i polecają przydatne poprawki, które wdrażają Państwo sami. Interwencja w aplikacji jest rozliczana godzinowo lub ryczałtowo.

Skontaktuj się z nami