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.
Autor: Simon Vasconcelos Lee
Opublikowano 19 listopada 2026Czas czytania: 11 minut
ignisda/ryot i PostgreSQL 18, z portem 8000 opublikowanym na 127.0.0.1 za odwrotnym proxy z HTTPS.SERVER_ADMIN_ACCESS_TOKEN w pliku .env i ustawić FRONTEND_URL na swój publiczny adres.USERS_ALLOW_REGISTRATION=false, aby zamknąć rejestrację na prywatnej instancji.pg_dump, a aktualizuje przez zmianę tagu obrazu.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ę.
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.
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.
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:
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:
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: plik referencyjny publikuje go bez adresu, a Docker otwiera go wtedy na wszystkich adresach serwera. Opublikowany lokalnie, jest osiągalny wyłącznie przez odwrotne proxy.postgres jako użytkownika i hasła. Tutaj dedykowany użytkownik ryot otrzymuje losowe hasło, w zapisie szesnastkowym, aby nie wymagało escapowania w DATABASE_URL.SERVER_ADMIN_ACCESS_TOKEN jest wymagany: autoryzuje operacje administratora przez API i szyfruje sekrety uwierzytelniania dwuskładnikowego Państwa użytkowników. Proszę zachować go w tajemnicy i pozostawić bez zmian: z innym tokenem tych sekretów nie da się już odczytać.FRONTEND_URL to Państwa publiczny adres, z https://. Ryot używa go jako podstawy generowanych linków, a OpenID Connect go wymaga.TZ to strefa czasowa zaplanowanych zadań, domyślnie GMT: proszę podać swoją, z listy IANA.v10 z pull_policy: always, co przy każdym starcie śledzi każde wydanie pomniejsze. Pełna wersja, tutaj v10.5.8, pozwala Państwu wybrać moment każdej aktualizacji.postgres_storage przechowuje wszystkie Państwa dane. PostgreSQL 18 trzyma je w /var/lib/postgresql, dlatego wolumen jest zamontowany tam, a nie w /var/lib/postgresql/data, jak przy starszych wersjach.Pierwsze uruchomienie wykonuje migracje bazy danych i pobiera katalog ćwiczeń; na naszym testowym VPS Ryot odpowiedział po kilku sekundach. Aby sprawdzić, czy odpowiada:
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.
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.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.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:
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”.
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.
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:
| Media | Dostawca | Co ustawić |
|---|---|---|
| Książki | Open Library | Nic: działa od razu. Google Books i Hardcover są opcjonalne, z ich kluczem API |
| Filmy i seriale | TMDB lub TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, API Read Access Token bezpłatnego konta TMDB, albo MOVIES_AND_SHOWS_TVDB_API_KEY |
| Gry wideo | IGDB, przez Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID i VIDEO_GAMES_TWITCH_CLIENT_SECRET, z aplikacji w konsoli deweloperskiej Twitch |
| Muzyka | Spotify, opcjonalnie | MUSIC_SPOTIFY_CLIENT_ID i MUSIC_SPOTIFY_CLIENT_SECRET |
| Import anime | MyAnimeList | ANIME_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.
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:
(
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.
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ę:
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 zatrzymuje przywracanie przy pierwszym błędzie, zamiast kontynuować i zgłaszać błędy na końcu, a && przerywają w tym miejscu całą sekwencję: Ryot pozostaje zatrzymany. To, co zostało wczytane przed błędem, pozostaje w bazie, więc po usunięciu przyczyny proszę zacząć ponownie od dropdb.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.
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:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop śledzi gałąź główną: dokumentacja ostrzega, że często ma poważne błędy i może utracić dane. Proszę pozostać przy wydaniach.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.
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.
| Temat | Nasze zespoły | Państwo |
|---|---|---|
| Serwer | Aktualizacje systemu i zabezpieczeń, w tym interwencje na serwerze | Moment dogodny dla Państwa |
| Nadzór | Serwer pod opieką całą dobę, 7 dni w tygodniu, z interwencją bez czekania na Państwa telefon | Państwa historia, kolekcje i integracje w Ryot |
| Ryot | Proaktywna 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żytkownicy | Serwer, który ich obsługuje, nadzorowany i objęty kopiami zapasowymi | Konta, rejestracja i logowanie jednokrotne |
| Kopie zapasowe | Co noc, szyfrowane i przechowywane poza maszyną; przywracanie w cenie | Zrzuty bazy danych i eksporty JSON właściwe dla Ryot oraz zgłoszenie prośby o przywrócenie, gdy będzie potrzebne |
| Migracja | Migracja Państwa obecnego serwera, bezpłatna | Moment 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ą.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Simafri
Porozmawiajmy o Państwa projekcie
Proszę powiedzieć nam w kilku słowach, czego Państwo potrzebują: odpowiemy szybko.
Dziękujemy! Państwa zapytanie zostało wysłane. Wkrótce się odezwiemy.
Wolą Państwo e-mail? Proszę napisać do nas na support@simafri.com.