Hostovat Ryot na Managed VPS: váš tracker médií a tréninků

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.

Simon Vasconcelos Lee Autor: Publikováno 19. listopadu 2026Doba čtení: 11 minut

Všichni průvodci

To nejdůležitější

  1. Licence GPL-3.0 vám dovoluje provozovat Ryot pro sebe, svou rodinu nebo svůj klub, aniž byste kupovali licenci; Ryot Pro, placený klíč, přidává funkce nad stejným obrazem.
  2. Nainstalujte ho pomocí Docker Compose: obraz ignisda/ryot a PostgreSQL 18, s portem 8000 publikovaným na 127.0.0.1 za reverzní proxy s HTTPS.
  3. Vložte heslo databáze a SERVER_ADMIN_ACCESS_TOKEN do souboru .env a nastavte FRONTEND_URL na svou veřejnou adresu.
  4. První vytvořený účet se stane správcem; potom nastavte USERS_ALLOW_REGISTRATION=false, abyste na soukromé instanci zavřeli registraci.
  5. Knihy fungují hned; filmy a seriály potřebují token TMDB, videohry aplikaci Twitch. Zálohujte pomocí pg_dump a aktualizujte změnou tagu obrazu.

Co Ryot umí

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.

Co dovoluje licence GPL-3.0

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.

Prostředky, se kterými počítat

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.

Instalace pomocí Docker Compose

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:

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 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:

Terminál, v /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

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á:

Terminál
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.

HTTPS: reverzní proxy

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á.

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

První účet, registrace a pozvánky

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í:

  1. Otevřete svou adresu: Ryot zobrazí přihlašovací stránku.
  2. Klikněte na „Create a new account?“ a potom zadejte uživatelské jméno a dvakrát heslo.
  3. Zaregistrujte se a potom se přihlaste novými údaji: ocitnete se na nástěnce, s úvodní prohlídkou.
  4. V části „Settings“, „Users“ se váš účet zobrazuje s rolí Admin.

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“.

Pozvání dalších uživatelů

  1. V části „Settings“, „Users“ klikněte na tlačítko + vedle nadpisu.
  2. Zadejte uživatelské jméno dané osoby: Ryot vytvoří účet a zobrazí jednorázový odkaz.
  3. Pošlete odkaz: osoba ho otevře, zvolí si heslo a potom se přihlásí.

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í.

Filmy, seriály a hry: klíče API

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édiaPoskytovatelCo nastavit
KnihyOpen LibraryNic: funguje hned. Google Books a Hardcover jsou volitelné, s jejich klíčem API
Filmy a seriályTMDB nebo TVDBMOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, API Read Access Token bezplatného účtu TMDB, nebo MOVIES_AND_SHOWS_TVDB_API_KEY
VideohryIGDB, přes TwitchVIDEO_GAMES_TWITCH_CLIENT_ID a VIDEO_GAMES_TWITCH_CLIENT_SECRET, z aplikace ve vývojářské konzoli Twitch
HudbaSpotify, volitelněMUSIC_SPOTIFY_CLIENT_ID a MUSIC_SPOTIFY_CLIENT_SECRET
Import animeMyAnimeListANIME_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é.

Zálohy

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ří:

Terminál, v /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
)

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.

Obnova

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:

Terminál, v /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

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.

Aktualizace

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:

Terminál, v /opt/ryot
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration

Telemetrie

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.

Kdo co dělá na Managed VPS

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émaNaše týmyVy
ServerAktualizace systému a zabezpečení, včetně zásahů na serveruOkamžik, který vám vyhovuje
DohledServer 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
RyotProaktivní sledování: chyby, zpomalení, databáze a místo na disku zachycené, doporučená opravaJeho 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álohyKaž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
MigraceVáš stávající server přenesen zdarmaOkamž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.

Ryot na serveru, o který se staráme za vás

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.

Objevit Managed VPS

Časté otázky

Je Ryot 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ěží.

Jak nainstalovat Ryot pomocí Docker Compose?

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.

Jaké jsou výchozí přihlašovací údaje Ryot?

Žá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.

Proč Ryot nenachází filmy ani seriály?

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.

Kolik paměti Ryot potřebuje?

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.

Jak zálohovat Ryot?

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.

Jak aktualizovat Ryot?

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.

Pokrývá Managed VPS i Ryot?

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.

Kontaktujte nás