Hostovanie Ryot na Managed VPS: váš tracker médií a tréningov

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.

Simon Vasconcelos Lee Autor: Publikované 19. novembra 2026Čas čítania: 11 minút

Všetci sprievodcovia

To najdôležitejšie

  1. Licencia GPL-3.0 vám umožňuje prevádzkovať Ryot pre seba, svoju rodinu alebo svoj klub bez kupovania licencie; Ryot Pro, platený kľúč, pridáva funkcie nad tým istým obrazom.
  2. Nainštalujte ho cez Docker Compose: obraz ignisda/ryot a PostgreSQL 18, s portom 8000 publikovaným na 127.0.0.1 za reverznou proxy s HTTPS.
  3. Vložte heslo databázy a SERVER_ADMIN_ACCESS_TOKEN do súboru .env a nastavte FRONTEND_URL na svoju verejnú adresu.
  4. Prvý vytvorený účet sa stane správcom; potom nastavte USERS_ALLOW_REGISTRATION=false, aby ste na súkromnej inštancii zatvorili registráciu.
  5. Knihy fungujú hneď; filmy a seriály potrebujú token TMDB, videohry aplikáciu Twitch. Zálohujte pomocou pg_dump a aktualizujte zmenou tagu obrazu.

Čo Ryot robí

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.

Čo umožňuje licencia GPL-3.0

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.

Prostriedky, s ktorými treba počítať

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

Inštalácia pomocou Docker Compose

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:

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

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

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

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

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

HTTPS: reverzná proxy

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.

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

Prvý účet, registrácie a pozvánky

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

  1. Otvorte svoju adresu: Ryot zobrazí prihlasovaciu stránku.
  2. Kliknite na „Create a new account?“ a potom zadajte používateľské meno a dvakrát heslo.
  3. Zaregistrujte sa a potom sa prihláste novými údajmi: ocitnete sa na nástenke, s úvodnou prehliadkou.
  4. V časti „Settings“, „Users“ sa váš účet zobrazuje s rolou Admin.

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

Pozvanie ďalších používateľov

  1. V časti „Settings“, „Users“ kliknite na tlačidlo + vedľa nadpisu.
  2. Zadajte používateľské meno danej osoby: Ryot vytvorí účet a zobrazí jednorazový odkaz.
  3. Pošlite odkaz: osoba ho otvorí, zvolí si heslo a potom sa prihlási.

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.

Filmy, seriály a hry: kľúče API

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ť
KnihyOpen LibraryNič: funguje hneď. Google Books a Hardcover sú voliteľné, s ich kľúčom API
Filmy a seriályTMDB alebo TVDBMOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, API Read Access Token bezplatného účtu TMDB, alebo MOVIES_AND_SHOWS_TVDB_API_KEY
VideohryIGDB, cez TwitchVIDEO_GAMES_TWITCH_CLIENT_ID a VIDEO_GAMES_TWITCH_CLIENT_SECRET, z aplikácie vo vývojárskej konzole Twitch
HudbaSpotify, voliteľneMUSIC_SPOTIFY_CLIENT_ID a MUSIC_SPOTIFY_CLIENT_SECRET
Import animeMyAnimeListANIME_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é.

Zálohy

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

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
)

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.

Obnova

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:

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

Aktualizácie

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:

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

Telemetria

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.

Kto čo robí na Managed VPS

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émaNaše tímyVy
ServerAktualizácie systému a zabezpečenia, vrátane zásahov na serveriČas, ktorý vám vyhovuje
DohľadServer sledovaný 24 hodín denne, 7 dní v týždni, so zásahom bez čakania na vaše zavolanieVaša história, zbierky a integrácie v Ryote
RyotProaktívne sledovanie: chyby, spomalenia, databáza a miesto na disku, s odporúčanou opravouJeho inštalácia, aktualizácie, kľúče API a nastavenia, ktoré zapracujete vy alebo váš AI asistent
PoužívateliaServer, ktorý ich nesie, sledovaný a zálohovanýÚčty, registrácie a jednotné prihlásenie
ZálohyKaždú noc, šifrované a uchovávané mimo stroja; obnova je v ceneVýpisy databázy a exporty JSON špecifické pre Ryot a žiadosť o obnovu, keď ju potrebujete
MigráciaVáš 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.

Ryot na serveri, o ktorý sa staráme za vás

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.

Objaviť Managed VPS

Časté otázky

Je Ryot zadarmo?

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

Ako nainštalovať Ryot pomocou Docker Compose?

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.

Aké sú predvolené prihlasovacie údaje Ryot?

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

Prečo Ryot nenachádza filmy ani seriály?

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.

Koľko pamäte Ryot potrebuje?

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.

Ako zálohovať Ryot?

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.

Ako aktualizovať Ryot?

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.

Pokrýva Managed VPS aj Ryot?

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.

Kontaktujte nás