A Ryot hosztolása Managed VPS-en azt jelenti, hogy annak előzményei, amit néz, olvas, játszik és emel, egy saját szerveren maradnak, amelyet csapataink naprakészen tartanak, és éjjel-nappal felügyelnek. A Ryot GPL-3.0 licenc alatt álló, szabad és nyílt forráskódú nyilvántartó alkalmazás filmekhez, sorozatokhoz, könyvekhez, játékokhoz, podcastokhoz, zenéhez és edzésekhez. Ez az útmutató a hivatalos Docker-képét követi a v10.5.8-as verzióban, és minden parancsot lefuttattunk egy Simafri VPS-en, mielőtt megírtuk: a telepítést Docker Compose-zal és PostgreSQL-lel, a HTTPS-t, az első fiókot, az egyes médiatípusok API-kulcsait, a mentéseket és a frissítéseket.
Szerző: Simon Vasconcelos Lee
Közzétéve 2026. november 19-énOlvasási idő: 11 perc
ignisda/ryot kép és a PostgreSQL 18, a 8000-es portot a 127.0.0.1 címen közzétéve, egy HTTPS-es fordított proxy mögött.SERVER_ADMIN_ACCESS_TOKEN értékét egy .env fájlba, és állítsa a FRONTEND_URL változót a nyilvános címére.USERS_ALLOW_REGISTRATION=false értéket, hogy egy privát példányon lezárja a regisztrációt.pg_dump eszközzel, a frissítéshez pedig módosítsa a kép címkéjét.A Ryot, a „Roll Your Own Tracker” rövidítése, kiejtve „rájot”, egy helyen őrzi, amit látott, olvasott, játszott és edzett, statisztikákkal, a közelgő megjelenések naptárával és saját gyűjteményekkel. Fejlesztője, IgnisDa, Rustban írja, egy webes felülettel, amelyet alkalmazásként telepíthet a telefonjára.
A Ryot a GNU General Public License 3-as verziója (GPL-3.0) alatt jelenik meg. Ingyenesen használhatja saját magának, a családjának, a klubjának vagy a cégének, másolhatja és módosíthatja. Ha módosított változatot terjeszt, a forráskódját is ugyanezen licenc alatt terjeszti. A szoftvert garancia nélkül adják.
A Ryot Pro a fejlesztő által árusított fizetős kulcs, amely további funkciókat old fel, például a profilmegosztást és a személyre szabott ajánlásokat. Ugyanannak a képnek egy SERVER_PRO_KEY változójába kerül, és a szerver a közösségi változatra áll vissza, ha a kulcs lejár. Ebben az útmutatóban semmi sem igényli.
A dokumentáció nem ír elő minimális méretet, a Ryot pedig könnyű. Ezt mértük a frissen telepített tesztszerverünkön:
A szerver mérete tehát a felhasználók számától és a Ryot mellett futtatott többi alkalmazástól függ. Egy Managed VPS esetén írja le nekünk, hogyan használja, és mi azt a méretet javasoljuk, amely megfelel.
A Ryot egyetlen képként érkezik, ignisda/ryot néven, amely ghcr.io/ignisda/ryot néven is megjelenik, és a 8000-es porton a felületet és az API-t is kiszolgálja. PostgreSQL 15-re vagy újabbra van szüksége, amely mellette fut, a saját konténerében. Egy olyan szerveren, amelyen a Docker Engine és a Compose bővítménye a Docker Ubuntuhoz készült tárolójából van telepítve, hozzon létre egy mappát, például /opt/ryot néven, és tegye bele ezt a compose.yaml fájlt, amely a telepítési oldal fájlján alapul:
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:
A két titkos érték egy mellette lévő .env fájlba kerül, amelyet a Docker Compose magától beolvas. Hozza létre úgy, hogy csak a root olvashassa, majd indítsa el a stacket:
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 címen közzétéve: a referenciafájl cím nélkül teszi közzé, a Docker pedig ilyenkor a szerver minden címén megnyitja. Helyileg közzétéve csak a fordított proxyn keresztül érhető el.postgres értéket használja felhasználónévként és jelszóként. Itt egy külön ryot felhasználó véletlenszerű jelszót kap, hexadecimális formában, hogy a DATABASE_URL változóban ne kelljen escape-elni.SERVER_ADMIN_ACCESS_TOKEN kötelező: engedélyezi az adminisztrátori műveleteket az API-n keresztül, és titkosítja a felhasználói kétlépcsős azonosításához tartozó titkos értékeket. Tartsa titokban, és tartsa változatlanul: egy másik tokennel ezek a titkos értékek többé nem olvashatók.FRONTEND_URL az Ön nyilvános címe, https:// előtaggal. A Ryot az általa előállított hivatkozások alapjaként használja, és az OpenID Connectnek is szüksége van rá.TZ az ütemezett feladatok időzónája, alapértelmezésként GMT: adja meg a sajátját, az IANA listájából.v10 címkét javasolja pull_policy: always beállítással, amely minden indításkor követi az összes alverziót. A teljes verziószám, itt v10.5.8, lehetővé teszi, hogy Ön válassza meg az egyes frissítések időpontját.postgres_storage, az összes adatát őrzi. A PostgreSQL 18 a /var/lib/postgresql alatt tárolja őket, ezért a kötet oda van csatolva, és nem a /var/lib/postgresql/data útvonalra, mint a régebbi verzióknál.Az első indítás lefuttatja az adatbázis-migrációkat, és letölti a gyakorlatkatalógust; a tesztszerverünkön a Ryot néhány másodperc alatt válaszolt. Annak ellenőrzéséhez, hogy válaszol:
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
Az első parancs 200 választ ad. A második JSON formában visszaadja a szerver által betöltött konfigurációt, a titkos értékeket kitakarva: kényelmes módja egy változó ellenőrzésének.
A konténer HTTP-n, a 8000-es porton szolgálja ki a Ryotot. A HTTPS-t egy előtte álló fordított proxy kezeli, amelynek továbbítania kell a nyilvános Host fejlécet és az X-Forwarded-Proto fejlécet. Mi a Caddyt teszteltük, a hivatalos Debian- és Ubuntu-tárolójából telepítve: maga szerzi be a Let’s Encrypt-tanúsítványt, megújítja, és alapértelmezésként továbbítja ezeket a fejléceket.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES változóba kerül.A Ryotnak nincs alapértelmezett fiókja, és egy új példányon a regisztráció nyitva áll. Az első létrehozott fiók az Admin szerepkört kapja; a továbbiak normál felhasználók. Hozza létre a sajátját közvetlenül az első indítás után:
Privát példány esetén zárja le a regisztrációt: adja hozzá a USERS_ALLOW_REGISTRATION=false beállítást a ryot szolgáltatás környezetéhez, majd futtassa a docker compose up -d parancsot. A tesztszerverünkön a „Create a new account?” hivatkozás eltűnt, a regisztrációs címről indított regisztrációs kísérletet pedig a szerver a „Registration is disabled” üzenettel elutasította.
Lezárt regisztráció mellett is kipróbáltuk: a meghívott fiók normál felhasználóként jött létre, a jelszavát a hivatkozásról állították be, és elérte a saját vezérlőpultját.
Ha inkább a céges fiókjaival jelentkezne be, a Ryot támogatja az OpenID Connectet: állítsa be a SERVER_OIDC_CLIENT_ID, a SERVER_OIDC_CLIENT_SECRET és a SERVER_OIDC_ISSUER_URL értékét, és adja meg a szolgáltatójánál a https://ryot.example.com/api/auth címet átirányítási címként.
A Ryot minden médiatípus adatait és borítóit egy szolgáltatótól szerzi be. Egyesek kulcs nélkül működnek, másokhoz a saját kulcsa kell, mivel a közös kulcsokat a v9-ben eltávolították:
| Média | Szolgáltató | Mit kell beállítani |
|---|---|---|
| Könyvek | Open Library | Semmit: azonnal működik. A Google Books és a Hardcover nem kötelező, a saját API-kulcsukkal |
| Filmek és sorozatok | TMDB vagy TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, egy ingyenes TMDB-fiók API Read Access Tokenje, vagy MOVIES_AND_SHOWS_TVDB_API_KEY |
| Videojátékok | IGDB, a Twitchen keresztül | VIDEO_GAMES_TWITCH_CLIENT_ID és VIDEO_GAMES_TWITCH_CLIENT_SECRET, egy, a Twitch fejlesztői konzoljában létrehozott alkalmazásból |
| Zene | Spotify, nem kötelező | MUSIC_SPOTIFY_CLIENT_ID és MUSIC_SPOTIFY_CLIENT_SECRET |
| Anime importálása | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, csak a MyAnimeListből való importáláshoz szükséges |
Ezek a kulcsok titkos értékek: tegye őket a .env fájlba, adjon hozzá egy sort, például - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN}, a ryot szolgáltatás környezetéhez, majd futtassa a docker compose up -d parancsot. A dokumentáció konfigurációs oldala felsorolja az összes többi változót.
Minden két helyen található: a PostgreSQL-adatbázisban, a postgres_storage kötetben, és a .env fájljában. Ez utóbbit tartsa biztonságos helyen: a SERVER_ADMIN_ACCESS_TOKEN szükséges az adatbázisban tárolt kétlépcsős titkos értékek olvasásához. A PostgreSQL-kép tartalmazza a pg_dump eszközt. A dump minden fiókot és annak előzményeit tartalmazza, ezért hozza létre úgy, hogy csak a root olvashassa, zárójelek közé tett umask 077 paranccsal: a munkamenete többi része megtartja a szokásos maszkját. Egy már létező fájl felülíráskor megtartja a jogosultságait, ezért a find sor először lezárja a mappában már meglévő dumpokat és másolatokat, mielőtt bármi íródna, és leállítja a mentést, ha ez nem sikerül:
(
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
)
Ütemezze ezt a másolatot, és küldje a szerveren kívülre. A lemezre téve a dumpok a szerver éjszakai mentéseibe is bekerülnek.
Ugyanazon vagy egy új telepítésen, ugyanazzal a .env fájllal állítsa le az alkalmazást, cserélje le az adatbázist egy üresre, töltse bele a dumpot, majd indítsa el újra az alkalmazást:
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 az első hibánál leállítja a visszaállítást, ahelyett hogy folytatná, és a végén jelentené a hibákat, az && jelek pedig ott megállítják a sorozatot: a Ryot leállítva marad. Ami a hiba előtt betöltődött, az adatbázisban marad, ezért a hiba okának elhárítása után kezdje újra a dropdb lépéstől.A teljes ciklust pontosan ezekkel a parancsokkal próbáltuk ki a VPS-ünkön: dump, az adatbázis törlése és üresen újbóli létrehozása, visszaállítás. A két fiók, a gyűjteményeik és a 876 gyakorlat visszatért, és az adminisztrátor azonnal újra be tudott jelentkezni.
A Ryot a saját adatait JSON-ba is exportálja, az „Imports and Exports” beállítási oldalról, és vissza is tudja importálni őket. Ehhez az exporthoz S3-kompatibilis fájltárolóra van szükség; a fenti adatbázis-dump nélküle is működik.
A Ryot gyakran jelenik meg, nagyjából hetente. Olvassa el a kiadási megjegyzéseket, készítsen mentést, módosítsa a kép címkéjét a compose.yaml fájlban, majd töltse le az új képet, és hozza létre újra a konténert. Az adatbázis-migrációk indításkor maguktól lefutnak:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop címke a fő ágat követi: a dokumentáció figyelmeztet, hogy gyakran súlyos hibákat tartalmaz, és adatvesztést okozhat. Maradjon a hivatalos kiadásoknál.A Ryot névtelen használati adatokat gyűjt, oldalmegtekintéseket és néhány eseményt, a fejlesztője által saját maga üzemeltetett Umami-példányon. A kikapcsolásához adja hozzá a DISABLE_TELEMETRY=true beállítást a ryot szolgáltatás környezetéhez, majd futtassa a docker compose up -d parancsot.
A saját üzemeltetés az alkalmazás mellett a szerver gondozását is megköveteli. Egy Managed VPS esetén csapataink átveszik a szervert, és proaktívan követik a példányát; a Ryot továbbra is az Ön szoftvere marad, az Ön előzményeivel és beállításaival.
| Téma | Csapataink | Ön |
|---|---|---|
| A szerver | Rendszer- és biztonsági frissítések, a szerveren végzett beavatkozásokkal együtt | Az Önnek megfelelő időpont |
| A felügyelet | Éjjel-nappal, a hét minden napján követett szerver, beavatkozás a hívására való várakozás nélkül | Az előzményei, a gyűjteményei és az integrációi a Ryotban |
| Ryot | Proaktív követés: a hibák, lassulások, az adatbázis és a lemezterület észlelése, javítás ajánlása | A telepítése, a frissítései, az API-kulcsai és a beállításai, amelyeket Ön vagy MI-asszisztense alkalmaz |
| A felhasználók | A szerver, amely hordozza őket, felügyelve és mentve | A fiókok, a regisztráció és az egyszeri bejelentkezés |
| A mentések | Minden éjjel, titkosítva és a gépen kívül őrizve; a visszaállítással együtt | A Ryot saját adatbázis-dumpjai és JSON-exportjai, és a visszaállítási kérés, amikor szüksége van rá |
| Az átköltöztetés | A jelenlegi szervere átköltöztetve, ingyenesen | Az átállás időpontja |
Ha inkább azt szeretné, hogy csapataink magában az alkalmazásban avatkozzanak be, ez a szolgáltatás óradíjban vagy átalánydíjban számlázódik, a beavatkozás előtt közölt árajánlattal.
Egy Simafri Managed VPS esetében csapataink naprakészen tartják Ryot-példánya szerverét, éjjel-nappal felügyelik, és beavatkoznak anélkül, hogy a hívására várnának; proaktívan a példányát is követik, és javasolják a hasznos javításokat, amelyeket Ön vagy MI-asszisztense alkalmaz. A mentések minden éjjel titkosítva, a gépen kívül készülnek, a visszaállításuk a díj része, jelenlegi szervere átköltöztetése pedig ingyenes.
Igen. A Ryot GPL-3.0 licenc alatt áll: futtathatja saját magának, a családjának vagy a csapatának, licenc vásárlása nélkül. A Ryot Pro egy nem kötelező, fizetős kulcs, amely további funkciókat ad ugyanahhoz a képhez. Csak az azt futtató szerver költsége marad.
Használja az ignisda/ryot képet és a PostgreSQL 18-at egy compose.yaml fájlban. Tegye az adatbázis jelszavát és a SERVER_ADMIN_ACCESS_TOKEN értékét egy .env fájlba, állítsa a FRONTEND_URL változót a https-es címére, tegye közzé a 8000-es portot a 127.0.0.1 címen, futtassa a docker compose up -d parancsot, és helyezzen elé egy HTTPS-es fordított proxyt.
Nincsenek ilyenek. Kattintson a bejelentkezési oldalon a „Create a new account?” hivatkozásra: az első létrehozott fiók lesz az adminisztrátor. Ezután állítsa be a USERS_ALLOW_REGISTRATION=false értéket a regisztráció lezárásához; az adminisztrátor a Settings, Users részből hívja meg a többi felhasználót, egy egyszer használható hivatkozással.
A v9 óta a filmekhez és sorozatokhoz saját TMDB-token kell: hozzon létre egy ingyenes TMDB-fiókot, igényeljen API-kulcsot, és adja meg annak API Read Access Tokenjét a MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN változóban. A videojátékokhoz Twitch-alkalmazás kell, a könyvek viszont kulcs nélkül is működnek.
Kevés. A tesztszerverünkön egy friss telepítés körülbelül 240-300 MB-ot használt a Ryothoz és 70 MB-ot a PostgreSQL-hez, a két kép pedig körülbelül 810 MB lemezterületet foglal.
Készítsen dumpot a PostgreSQL-adatbázisról a docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot paranccsal umask 077 mellett, hogy csak a root olvashassa, és őrizzen meg egy másolatot a .env fájljáról. A visszaállításhoz állítsa le az alkalmazást, hozza létre újra üresen az adatbázist a dropdb és a createdb paranccsal, majd töltse be a dumpot a pg_restore --exit-on-error --no-owner paranccsal.
Olvassa el a kiadási megjegyzéseket, és készítsen mentést, módosítsa a kép címkéjét a compose.yaml fájlban, majd futtassa a docker compose pull és a docker compose up -d parancsot. Az adatbázis-migrációk indításkor maguktól lefutnak. Főverziók között kövesse a migrációs oldalt.
A Managed VPS a szervert fedi le: a rendszert, a biztonságot, a felügyeletet és a mentéseket. Csapataink emellett proaktívan követik a példányát, és javasolják a hasznos javításokat, amelyeket Ön alkalmaz. Az alkalmazáson belüli beavatkozás óradíjban vagy átalánydíjban számlázódik.
Simafri
Beszéljünk a weboldaláról
Meséljen néhány szóban a projektjéről: hamarosan jelentkezünk.
Köszönjük! Kérését elküldtük. Hamarosan válaszolunk.
Inkább e-mailben? Írjon nekünk ide: support@simafri.com.