Hostovanie Ryot na Managed VPS znamená uchovávať históriu toho, čo sledujete, čítate, hráte a dvíhate v posilňovni, na vlastnom serveri, ktorý naše tímy udržiavajú aktuálny a dohliadajú naň vo dne v noci. Ryot je slobodný tracker s otvoreným zdrojovým kódom pod licenciou GPL-3.0, pre filmy, seriály, knihy, hry, podcasty, hudbu a tréningy. Tento sprievodca postupuje podľa jeho oficiálneho obrazu Docker vo verzii v10.5.8 a každý príkaz sme pred jeho napísaním spustili na VPS Simafri: inštalácia cez Docker Compose a PostgreSQL, HTTPS, prvý účet, kľúče API pre jednotlivé typy médií, zálohy a aktualizácie.
Autor: Simon Vasconcelos Lee
Publikované 19. novembra 2026Čas čítania: 11 minút
ignisda/ryot a PostgreSQL 18, s portom 8000 publikovaným na 127.0.0.1 za reverznou proxy s HTTPS.SERVER_ADMIN_ACCESS_TOKEN do súboru .env a nastavte FRONTEND_URL na svoju verejnú adresu.USERS_ALLOW_REGISTRATION=false, aby ste na súkromnej inštancii zatvorili registráciu.pg_dump a aktualizujte zmenou tagu obrazu.Ryot, z „Roll Your Own Tracker“, vyslovovaný ako „riot“, uchováva na jednom mieste, čo ste videli, prečítali, odohrali a odcvičili, so štatistikami, kalendárom toho, čo prichádza, a vlastnými zbierkami. Jeho vývojár, IgnisDa, ho píše v Ruste, s webovým rozhraním, ktoré si môžete nainštalovať do telefónu ako aplikáciu.
Ryot vychádza pod licenciou GNU General Public License, verzia 3 (GPL-3.0). Môžete ho používať bezplatne, pre seba, svoju rodinu, svoj klub alebo svoju firmu, kopírovať ho a upravovať. Ak šírite upravenú verziu, šírite aj jej zdrojový kód pod rovnakou licenciou. Softvér sa poskytuje bez záruky.
Ryot Pro je platený kľúč, ktorý predáva jeho vývojár a ktorý odomyká ďalšie funkcie, ako je zdieľanie profilu a personalizované odporúčania. Vkladá sa do premennej SERVER_PRO_KEY toho istého obrazu a po vypršaní kľúča sa server vráti ku komunitnej verzii. Nič v tomto sprievodcovi ho nepotrebuje.
Dokumentácia neuvádza žiadnu minimálnu veľkosť a Ryot je nenáročný. Toto sme namerali na našom testovacom VPS, čerstvo po inštalácii:
Veľkosť servera teda závisí od počtu používateľov a od ďalších aplikácií, ktoré vedľa Ryotu prevádzkujete. Na Managed VPS nám opíšte svoje používanie a odporučíme vám vhodnú veľkosť.
Ryot sa dodáva ako jediný obraz, ignisda/ryot, publikovaný aj ako ghcr.io/ignisda/ryot, ktorý na porte 8000 obsluhuje rozhranie aj API. Potrebuje PostgreSQL 15 alebo novší, spustený vedľa neho vo vlastnom kontajneri. Na serveri s Docker Engine a jeho pluginom Compose, nainštalovanými z repozitára Dockera pre Ubuntu, vytvorte priečinok, napríklad /opt/ryot, a vložte doň tento compose.yaml, vychádzajúci zo súboru na stránke o inštalácii:
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 tajné kľúče patria do súboru .env vedľa neho, ktorý Docker Compose načíta sám. Vytvorte ho tak, aby ho mohol čítať len root, a potom spustite 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: referenčný súbor ho publikuje bez adresy a Docker ho potom otvorí na všetkých adresách servera. Publikovaný lokálne je dostupný len cez reverznú proxy.postgres ako používateľa aj heslo. Tu dostane vyhradený používateľ ryot náhodné heslo, v šestnástkovom zápise, aby v DATABASE_URL nevyžadovalo žiadne escapovanie.SERVER_ADMIN_ACCESS_TOKEN je povinný: autorizuje operácie správcu cez API a šifruje tajné kľúče dvojfaktorového overenia vašich používateľov. Uchovajte ho v tajnosti a ponechajte ho bez zmeny: s iným tokenom už tieto tajné kľúče nemožno prečítať.FRONTEND_URL je vaša verejná adresa, s https://. Ryot ju používa ako základ odkazov, ktoré generuje, a OpenID Connect ju vyžaduje.TZ je časové pásmo plánovaných úloh, predvolene GMT: zadajte svoje, zo zoznamu IANA.v10 s pull_policy: always, čo pri každom spustení sleduje každé menšie vydanie. Úplná verzia, tu v10.5.8, vám umožní zvoliť okamih každej aktualizácie.postgres_storage uchováva všetky vaše údaje. PostgreSQL 18 ich ukladá pod /var/lib/postgresql, a preto je zväzok pripojený tam, a nie na /var/lib/postgresql/data ako pri starších verziách.Prvé spustenie vykoná migrácie databázy a stiahne katalóg cvikov; na našom testovacom VPS Ryot odpovedal v priebehu niekoľkých sekúnd. Ak chcete overiť, že odpovedá:
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
Prvý príkaz odpovie 200. Druhý vráti konfiguráciu, ktorú server načítal, vo formáte JSON, so skrytými tajnými údajmi: praktický spôsob, ako skontrolovať premennú.
Kontajner obsluhuje Ryot cez HTTP, na porte 8000. HTTPS zabezpečuje reverzná proxy pred ním, ktorá musí odovzdávať verejnú hlavičku Host a X-Forwarded-Proto. Otestovali sme Caddy, nainštalovaný z jeho oficiálneho repozitára pre Debian a Ubuntu: certifikát Let’s Encrypt si sám získa, obnovuje ho a tieto hlavičky predvolene odovzdáva.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.Ryot nemá žiadny predvolený účet a na novej inštancii je registrácia otvorená. Prvý účet, ktorý vznikne, dostane rolu Admin; ďalšie sú bežní používatelia. Vytvorte si svoj hneď po prvom spustení:
Pri súkromnej inštancii registráciu zatvorte: pridajte USERS_ALLOW_REGISTRATION=false do prostredia služby ryot a potom spustite docker compose up -d. Na našom testovacom VPS odkaz „Create a new account?“ zmizol a pokus o registráciu z adresy registrácie server odmietol hláškou „Registration is disabled“.
Otestovali sme to so zatvorenou registráciou: pozvaný účet vznikol ako bežný používateľ, jeho heslo sa nastavilo z odkazu a dostal sa na svoju vlastnú nástenku.
Ak sa chcete namiesto toho prihlasovať firemnými účtami, Ryot podporuje OpenID Connect: nastavte SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET a SERVER_OIDC_ISSUER_URL a u svojho poskytovateľa zadajte https://ryot.example.com/api/auth ako adresu presmerovania.
Ryot získava podrobnosti a obálky každého typu médií od poskytovateľa. Niektorí fungujú bez kľúča, iní potrebujú váš vlastný, pretože zdieľané kľúče boli vo v9 odstránené:
| Médiá | Poskytovateľ | Čo nastaviť |
|---|---|---|
| Knihy | Open Library | Nič: funguje hneď. Google Books a Hardcover sú voliteľné, s ich kľúčom API |
| Filmy a seriály | TMDB alebo TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, API Read Access Token bezplatného účtu TMDB, alebo MOVIES_AND_SHOWS_TVDB_API_KEY |
| Videohry | IGDB, cez Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID a VIDEO_GAMES_TWITCH_CLIENT_SECRET, z aplikácie vo vývojárskej konzole Twitch |
| Hudba | Spotify, voliteľne | MUSIC_SPOTIFY_CLIENT_ID a MUSIC_SPOTIFY_CLIENT_SECRET |
| Import anime | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, potrebný len na import z MyAnimeList |
Tieto kľúče sú tajné: vložte ich do súboru .env, pridajte riadok ako - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} do prostredia služby ryot a potom spustite docker compose up -d. Stránka dokumentácie o konfigurácii uvádza všetky ostatné premenné.
Všetko je na dvoch miestach: v databáze PostgreSQL, vo zväzku postgres_storage, a vo vašom súbore .env. Ten uchovávajte v bezpečí: SERVER_ADMIN_ACCESS_TOKEN je potrebný na čítanie tajných kľúčov dvojfaktorového overenia uložených v databáze. Obraz PostgreSQL obsahuje pg_dump. Výpis obsahuje všetky účty a ich históriu, preto ho vytvorte tak, aby ho mohol čítať len root, s umask 077 v zátvorkách: zvyšok vašej relácie si ponechá svoju obvyklú masku. Súbor, ktorý už existuje, si pri prepísaní ponechá svoje oprávnenia, a preto riadok find najprv uzavrie výpisy a kópie, ktoré už v priečinku sú, skôr než sa čokoľvek zapíše, a zálohu zastaví, ak sa mu to nepodarí:
(
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
)
Túto kópiu naplánujte a posielajte ju mimo servera. Uložené na disku sa výpisy dostanú aj do nočných záloh servera.
Na tej istej alebo novej inštalácii, s rovnakým .env, zastavte aplikáciu, nahraďte databázu prázdnou, nahrajte do nej výpis a potom aplikáciu znova spustite:
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 zastaví obnovu pri prvej chybe, namiesto toho, aby pokračovala a chyby nahlásila na konci, a && tam zastavia celú postupnosť: Ryot zostane zastavený. Čo sa nahralo pred chybou, v databáze zostáva, takže po odstránení príčiny začnite znova od dropdb.Celý cyklus sme otestovali na našom VPS presne týmito príkazmi: výpis, databáza vymazaná a znova vytvorená prázdna, obnova. Oba účty, ich zbierky aj 876 cvikov sa vrátili a správca sa hneď znova prihlásil.
Ryot tiež exportuje vaše vlastné údaje do JSON, zo stránky nastavení „Imports and Exports“, a vie ich znova importovať. Tento export potrebuje úložisko súborov kompatibilné s S3; vyššie uvedený výpis databázy funguje aj bez neho.
Ryot vychádza často, zhruba raz týždenne. Prečítajte si poznámky k vydaniu, urobte zálohu, zmeňte tag obrazu v compose.yaml, potom stiahnite nový obraz a kontajner znova vytvorte. Migrácie databázy sa pri spustení vykonajú samy:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop sleduje hlavnú vetvu: dokumentácia varuje, že často obsahuje vážne chyby a môže prísť o údaje. Zostaňte pri vydaniach.Ryot zbiera anonymné údaje o používaní, zobrazenia stránok a niekoľko udalostí, na inštancii Umami, ktorú jeho vývojár sám hostuje. Ak to chcete vypnúť, pridajte DISABLE_TELEMETRY=true do prostredia služby ryot a potom spustite docker compose up -d.
Hostovanie na vlastnom serveri vyžaduje popri aplikácii starať sa aj o server. Na Managed VPS preberajú server naše tímy a vašu inštanciu proaktívne sledujú; Ryot zostáva vaším softvérom, s vašou históriou a vašimi nastaveniami.
| Téma | Naše tímy | Vy |
|---|---|---|
| Server | Aktualizácie systému a zabezpečenia, vrátane zásahov na serveri | Čas, ktorý vám vyhovuje |
| Dohľad | Server sledovaný 24 hodín denne, 7 dní v týždni, so zásahom bez čakania na vaše zavolanie | Vaša história, zbierky a integrácie v Ryote |
| Ryot | Proaktívne sledovanie: chyby, spomalenia, databáza a miesto na disku, s odporúčanou opravou | Jeho inštalácia, aktualizácie, kľúče API a nastavenia, ktoré zapracujete vy alebo váš AI asistent |
| Používatelia | Server, ktorý ich nesie, sledovaný a zálohovaný | Účty, registrácie a jednotné prihlásenie |
| Zálohy | Každú noc, šifrované a uchovávané mimo stroja; obnova je v cene | Výpisy databázy a exporty JSON špecifické pre Ryot a žiadosť o obnovu, keď ju potrebujete |
| Migrácia | Váš súčasný server prenesený zdarma | Čas prepnutia |
Ak by ste uprednostnili, aby naše tímy zasiahli priamo v aplikácii, táto služba sa fakturuje hodinovo alebo paušálne, s cenovou ponukou oznámenou pred zásahom.
S Managed VPS od Simafri udržiavajú naše tímy server vašej inštancie Ryot aktuálny, sledujú ho vo dne v noci a zasahujú bez čakania na vaše zavolanie; vašu inštanciu navyše proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy alebo váš AI asistent. Zálohy sa každú noc šifrujú a uchovávajú mimo stroja, ich obnova je v cene a migrácia vášho súčasného servera je zdarma.
Áno. Ryot je pod licenciou GPL-3.0: môžete ho prevádzkovať pre seba, svoju rodinu alebo svoj tím bez kupovania licencie. Ryot Pro je voliteľný platený kľúč, ktorý tomu istému obrazu pridáva funkcie. Zostávajú náklady na server, na ktorom beží.
Použite obraz ignisda/ryot a PostgreSQL 18 v súbore compose.yaml. Vložte heslo databázy a SERVER_ADMIN_ACCESS_TOKEN do súboru .env, nastavte FRONTEND_URL na svoju adresu https, publikujte port 8000 na 127.0.0.1, spustite docker compose up -d a predraďte reverznú proxy s HTTPS.
Žiadne nie sú. Na prihlasovacej stránke kliknite na „Create a new account?“: prvý vytvorený účet sa stane správcom. Potom nastavte USERS_ALLOW_REGISTRATION=false, aby ste registráciu zatvorili; správca pozýva ďalších používateľov zo Settings, Users, jednorazovým odkazom.
Od v9 potrebujú filmy a seriály váš vlastný token TMDB: založte si bezplatný účet TMDB, požiadajte o kľúč API a jeho API Read Access Token nastavte do MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Videohry potrebujú aplikáciu Twitch, zatiaľ čo knihy fungujú bez akéhokoľvek kľúča.
Málo. Na našom testovacom VPS spotrebovala čerstvá inštalácia asi 240 až 300 MB pre Ryot a 70 MB pre PostgreSQL a oba obrazy zaberajú asi 810 MB disku.
Vytvorte výpis databázy PostgreSQL príkazom docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot pod umask 077, aby ho mohol čítať len root, a uchovajte kópiu svojho súboru .env. Na obnovu zastavte aplikáciu, znova vytvorte prázdnu databázu pomocou dropdb a createdb a potom nahrajte výpis príkazom pg_restore --exit-on-error --no-owner.
Prečítajte si poznámky k vydaniu a urobte zálohu, zmeňte tag obrazu v compose.yaml, potom spustite docker compose pull a docker compose up -d. Migrácie databázy sa pri spustení vykonajú samy. Medzi hlavnými verziami postupujte podľa stránky o migrácii.
Managed VPS pokrýva server: systém, zabezpečenie, dohľad a zálohy. Naše tímy navyše vašu inštanciu proaktívne sledujú a odporúčajú vám užitočné opravy, ktoré zapracujete vy. Zásah v aplikácii sa fakturuje hodinovo alebo paušálne.
Simafri
Porozprávajme sa o vašom zámere
Povedzte nám v pár slovách, čo potrebujete: rýchlo sa vám ozveme.
Ďakujeme! Vaša žiadosť bola odoslaná. Čoskoro sa vám ozveme.
Máte radšej e-mail? Napíšte nám na support@simafri.com.