Hostovat Ryot na Managed VPS znamená uchovávat historii toho, co sledujete, čtete, hrajete a zvedáte v posilovně, na vlastním serveru, který naše týmy udržují aktuální a ve dne i v noci hlídají. Ryot je svobodný tracker s otevřeným zdrojovým kódem pod licencí GPL-3.0, pro filmy, seriály, knihy, hry, podcasty, hudbu a tréninky. Tento průvodce sleduje jeho oficiální obraz Docker ve verzi v10.5.8 a každý příkaz jsme před jeho napsáním spustili na VPS Simafri: instalaci pomocí Docker Compose a PostgreSQL, HTTPS, první účet, klíče API pro jednotlivé typy médií, zálohy a aktualizace.
Autor: Simon Vasconcelos Lee
Publikováno 19. listopadu 2026Doba čtení: 11 minut
ignisda/ryot a PostgreSQL 18, s portem 8000 publikovaným na 127.0.0.1 za reverzní proxy s HTTPS.SERVER_ADMIN_ACCESS_TOKEN do souboru .env a nastavte FRONTEND_URL na svou veřejnou adresu.USERS_ALLOW_REGISTRATION=false, abyste na soukromé instanci zavřeli registraci.pg_dump a aktualizujte změnou tagu obrazu.Ryot, z „Roll Your Own Tracker“, vyslovovaný jako „riot“, uchovává na jednom místě, co jste viděli, přečetli, odehráli a odcvičili, se statistikami, kalendářem toho, co přichází, a vlastními sbírkami. Jeho vývojář, IgnisDa, ho píše v Rustu, s webovým rozhraním, které si můžete nainstalovat do telefonu jako aplikaci.
Ryot je vydáván pod licencí GNU General Public License, verze 3 (GPL-3.0). Můžete ho používat zdarma, pro sebe, svou rodinu, svůj klub nebo svou firmu, kopírovat ho a upravovat. Pokud šíříte upravenou verzi, šíříte i její zdrojový kód pod stejnou licencí. Software se poskytuje bez záruky.
Ryot Pro je placený klíč, který prodává jeho vývojář a který odemyká další funkce, jako je sdílení profilu a personalizovaná doporučení. Vkládá se do proměnné SERVER_PRO_KEY stejného obrazu a po vypršení klíče se server vrátí ke komunitní verzi. Nic v tomto průvodci ho nepotřebuje.
Dokumentace neuvádí žádnou minimální velikost a Ryot je nenáročný. Toto jsme naměřili na našem testovacím VPS, čerstvě po instalaci:
Velikost serveru tedy závisí na počtu uživatelů a na dalších aplikacích, které vedle Ryotu provozujete. Na Managed VPS nám popište své použití a doporučíme vám vhodnou velikost.
Ryot se dodává jako jediný obraz, ignisda/ryot, publikovaný také jako ghcr.io/ignisda/ryot, který na portu 8000 obsluhuje rozhraní i API. Potřebuje PostgreSQL 15 nebo novější, spuštěný vedle něj ve vlastním kontejneru. Na serveru s Docker Engine a jeho pluginem Compose, nainstalovanými z repozitáře Dockeru pro Ubuntu, vytvořte složku, například /opt/ryot, a vložte do ní tento compose.yaml, vycházející ze souboru na stránce o instalaci:
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é klíče patří do souboru .env vedle něj, který Docker Compose načte sám. Vytvořte ho tak, aby ho mohl číst jen root, a potom spusťte 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í soubor ho publikuje bez adresy a Docker ho pak otevře na všech adresách serveru. Publikovaný lokálně je dostupný jen přes reverzní proxy.postgres jako uživatele i heslo. Zde dostane vyhrazený uživatel ryot náhodné heslo, v šestnáctkovém zápisu, aby v DATABASE_URL nevyžadovalo žádné escapování.SERVER_ADMIN_ACCESS_TOKEN je povinný: autorizuje operace správce přes API a šifruje tajné klíče dvoufázového ověření vašich uživatelů. Uchovejte ho v tajnosti a ponechte ho beze změny: s jiným tokenem už tyto tajné klíče nelze přečíst.FRONTEND_URL je vaše veřejná adresa, s https://. Ryot ji používá jako základ odkazů, které generuje, a OpenID Connect ji vyžaduje.TZ je časové pásmo plánovaných úloh, ve výchozím stavu GMT: zadejte své, ze seznamu IANA.v10 s pull_policy: always, což při každém spuštění sleduje každé menší vydání. Plná verze, zde v10.5.8, vám dovolí zvolit okamžik každé aktualizace.postgres_storage uchovává všechna vaše data. PostgreSQL 18 je ukládá pod /var/lib/postgresql, a proto je svazek připojen tam, a ne na /var/lib/postgresql/data jako u starších verzí.První spuštění provede migrace databáze a stáhne katalog cviků; na našem testovacím VPS Ryot odpověděl během několika sekund. Abyste ověřili, že odpovídá:
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
První příkaz odpoví 200. Druhý vrátí konfiguraci, kterou server načetl, ve formátu JSON, se skrytými tajnými údaji: praktický způsob, jak zkontrolovat proměnnou.
Kontejner obsluhuje Ryot přes HTTP, na portu 8000. HTTPS zajišťuje reverzní proxy před ním, která musí předávat veřejnou hlavičku Host a X-Forwarded-Proto. Otestovali jsme Caddy, nainstalovaný z jeho oficiálního repozitáře pro Debian a Ubuntu: certifikát Let’s Encrypt si sám získá, obnovuje ho a tyto hlavičky ve výchozím stavu předává.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.Ryot nemá žádný výchozí účet a na nové instanci je registrace otevřená. První účet, který vznikne, dostane roli Admin; další jsou běžní uživatelé. Vytvořte si svůj hned po prvním spuštění:
U soukromé instance registraci zavřete: přidejte USERS_ALLOW_REGISTRATION=false do prostředí služby ryot a potom spusťte docker compose up -d. Na našem testovacím VPS odkaz „Create a new account?“ zmizel a pokus o registraci z adresy registrace server odmítl hláškou „Registration is disabled“.
Otestovali jsme to se zavřenou registrací: pozvaný účet vznikl jako běžný uživatel, jeho heslo se nastavilo z odkazu a dostal se na svou vlastní nástěnku.
Pokud se chcete místo toho přihlašovat firemními účty, Ryot podporuje OpenID Connect: nastavte SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET a SERVER_OIDC_ISSUER_URL a u svého poskytovatele zadejte https://ryot.example.com/api/auth jako adresu přesměrování.
Ryot získává podrobnosti a obálky každého typu médií od poskytovatele. Někteří fungují bez klíče, jiní potřebují váš vlastní, protože sdílené klíče byly ve v9 odstraněny:
| Média | Poskytovatel | Co nastavit |
|---|---|---|
| Knihy | Open Library | Nic: funguje hned. Google Books a Hardcover jsou volitelné, s jejich klíčem API |
| Filmy a seriály | TMDB nebo TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, API Read Access Token bezplatného účtu TMDB, nebo MOVIES_AND_SHOWS_TVDB_API_KEY |
| Videohry | IGDB, přes Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID a VIDEO_GAMES_TWITCH_CLIENT_SECRET, z aplikace ve vývojářské konzoli Twitch |
| Hudba | Spotify, volitelně | MUSIC_SPOTIFY_CLIENT_ID a MUSIC_SPOTIFY_CLIENT_SECRET |
| Import anime | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, potřebný jen pro import z MyAnimeList |
Tyto klíče jsou tajné: vložte je do souboru .env, přidejte řádek jako - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} do prostředí služby ryot a potom spusťte docker compose up -d. Stránka dokumentace o konfiguraci uvádí všechny ostatní proměnné.
Vše je na dvou místech: v databázi PostgreSQL, ve svazku postgres_storage, a ve vašem souboru .env. Ten uchovávejte v bezpečí: SERVER_ADMIN_ACCESS_TOKEN je potřeba ke čtení tajných klíčů dvoufázového ověření uložených v databázi. Obraz PostgreSQL obsahuje pg_dump. Výpis obsahuje všechny účty a jejich historii, proto ho vytvořte tak, aby ho mohl číst jen root, s umask 077 v závorkách: zbytek vaší relace si ponechá svou obvyklou masku. Soubor, který už existuje, si při přepsání ponechá svá oprávnění, a proto řádek find nejdřív uzavře výpisy a kopie, které už ve složce jsou, dřív než se cokoli zapíše, a zálohu zastaví, pokud se mu to nepodaří:
(
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
)
Naplánujte tuto kopii a posílejte ji mimo server. Uložené na disku se výpisy dostanou i do nočních záloh serveru.
Na stejné nebo nové instalaci, se stejným .env, zastavte aplikaci, nahraďte databázi prázdnou, nahrajte do ní výpis a potom aplikaci znovu spusťte:
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 při první chybě, místo aby pokračovala a chyby nahlásila na konci, a && tam zastaví celou posloupnost: Ryot zůstane zastavený. Co se nahrálo před chybou, v databázi zůstává, takže po odstranění příčiny začněte znovu od dropdb.Celý cyklus jsme otestovali na našem VPS přesně těmito příkazy: výpis, databáze smazaná a znovu vytvořená prázdná, obnova. Oba účty, jejich sbírky i 876 cviků se vrátily a správce se hned znovu přihlásil.
Ryot také exportuje vaše vlastní data do JSON, ze stránky nastavení „Imports and Exports“, a umí je znovu importovat. Tento export potřebuje úložiště souborů kompatibilní s S3; výše uvedený výpis databáze funguje i bez něj.
Ryot vychází často, zhruba jednou týdně. Přečtěte si poznámky k vydání, proveďte zálohu, změňte tag obrazu v compose.yaml, potom stáhněte nový obraz a kontejner znovu vytvořte. Migrace databáze se při spuštění provedou samy:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop sleduje hlavní větev: dokumentace varuje, že často obsahuje vážné chyby a může přijít o data. Zůstaňte u vydání.Ryot sbírá anonymní údaje o používání, zobrazení stránek a několik událostí, na instanci Umami, kterou jeho vývojář sám hostuje. Chcete-li to vypnout, přidejte DISABLE_TELEMETRY=true do prostředí služby ryot a potom spusťte docker compose up -d.
Vlastní hosting vyžaduje, abyste kromě aplikace udržovali i server. Na Managed VPS se serveru ujímají naše týmy a vaši instanci proaktivně sledují; Ryot zůstává vaším softwarem, s vaší historií a vašimi nastaveními.
| Téma | Naše týmy | Vy |
|---|---|---|
| Server | Aktualizace systému a zabezpečení, včetně zásahů na serveru | Okamžik, který vám vyhovuje |
| Dohled | Server sledovaný 24 hodin denně, 7 dní v týdnu, se zásahem bez čekání na vaše volání | Vaše historie, sbírky a integrace v Ryotu |
| Ryot | Proaktivní sledování: chyby, zpomalení, databáze a místo na disku zachycené, doporučená oprava | Jeho instalace, aktualizace, klíče API a nastavení, které zapracujete vy nebo váš AI asistent |
| Uživatelé | Server, který je nese, hlídaný a zálohovaný | Účty, registrace a jednotné přihlášení |
| Zálohy | Každou noc, šifrované a uchovávané mimo stroj; obnova v ceně | Výpisy databáze a exporty JSON vlastní Ryotu a žádost o obnovu, když ji potřebujete |
| Migrace | Váš stávající server přenesen zdarma | Okamžik přepnutí |
Pokud dáváte přednost tomu, aby naše týmy zasáhly přímo v aplikaci, tato služba se účtuje po hodinách nebo paušálem, s cenovou nabídkou sdělenou před zásahem.
S Managed VPS od Simafri udržují naše týmy server vaší instance Ryot aktuální, hlídají ho ve dne i v noci a zasahují bez čekání na vaše volání; vaši instanci také proaktivně sledují a doporučí vám užitečné opravy, které zapracujete vy nebo váš AI asistent. Zálohy se každou noc šifrují a uchovávají mimo stroj, jejich obnova je v ceně a migrace vašeho stávajícího serveru je zdarma.
Ano. Ryot je pod licencí GPL-3.0: můžete ho provozovat pro sebe, svou rodinu nebo svůj tým, aniž byste kupovali licenci. Ryot Pro je volitelný placený klíč, který stejnému obrazu přidává funkce. Zbývají náklady na server, na kterém běží.
Použijte obraz ignisda/ryot a PostgreSQL 18 v souboru compose.yaml. Vložte heslo databáze a SERVER_ADMIN_ACCESS_TOKEN do souboru .env, nastavte FRONTEND_URL na svou adresu https, publikujte port 8000 na 127.0.0.1, spusťte docker compose up -d a předřaďte reverzní proxy s HTTPS.
Žádné nejsou. Na přihlašovací stránce klikněte na „Create a new account?“: první vytvořený účet se stane správcem. Potom nastavte USERS_ALLOW_REGISTRATION=false, abyste registraci zavřeli; správce zve další uživatele ze Settings, Users, jednorázovým odkazem.
Od v9 potřebují filmy a seriály váš vlastní token TMDB: založte si bezplatný účet TMDB, požádejte o klíč API a jeho API Read Access Token nastavte do MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Videohry potřebují aplikaci Twitch, zatímco knihy fungují bez jakéhokoli klíče.
Málo. Na našem testovacím VPS spotřebovala čerstvá instalace asi 240 až 300 MB pro Ryot a 70 MB pro PostgreSQL a oba obrazy zabírají asi 810 MB disku.
Vytvořte výpis databáze PostgreSQL příkazem docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot pod umask 077, aby ho mohl číst jen root, a uchovejte kopii svého souboru .env. Pro obnovu zastavte aplikaci, znovu vytvořte prázdnou databázi pomocí dropdb a createdb a potom nahrajte výpis příkazem pg_restore --exit-on-error --no-owner.
Přečtěte si poznámky k vydání a proveďte zálohu, změňte tag obrazu v compose.yaml, potom spusťte docker compose pull a docker compose up -d. Migrace databáze se při spuštění provedou samy. Mezi hlavními verzemi postupujte podle stránky o migraci.
Managed VPS pokrývá server: systém, zabezpečení, dohled a zálohy. Naše týmy navíc vaši instanci proaktivně sledují a doporučí vám užitečné opravy, které zapracujete vy. Zásah v aplikaci se účtuje po hodinách nebo paušálem.
Simafri
Promluvme si o vašem záměru
Řekněte nám v pár slovech, co potřebujete: rychle se vám ozveme.
Děkujeme! Vaše zpráva byla odeslána. Brzy se vám ozveme.
Máte raději e-mail? Napište nám na support@simafri.com.