Găzduirea Ryot pe un Managed VPS înseamnă să păstrați istoricul a ceea ce vizionați, citiți, jucați și ridicați la sală pe un server al dumneavoastră, pe care echipele noastre îl țin la zi și îl supraveghează zi și noapte. Ryot este un instrument de evidență liber și open source, sub licență GPL-3.0, pentru filme, seriale, cărți, jocuri, podcasturi, muzică și antrenamente. Acest ghid urmează imaginea sa Docker oficială, la versiunea v10.5.8, iar fiecare comandă a fost rulată de noi pe un VPS Simafri înainte de redactare: instalarea cu Docker Compose și PostgreSQL, HTTPS, primul cont, cheile API pentru fiecare tip de media, backupurile și actualizările.
Autor: Simon Vasconcelos Lee
Publicat la 19 noiembrie 2026Timp de citire: 11 minute
ignisda/ryot și PostgreSQL 18, cu portul 8000 publicat pe 127.0.0.1 în spatele unui proxy invers în HTTPS.SERVER_ADMIN_ACCESS_TOKEN într-un fișier .env și setați FRONTEND_URL la adresa dumneavoastră publică.USERS_ALLOW_REGISTRATION=false pentru a închide înregistrările pe o instanță privată.pg_dump, apoi actualizați schimbând eticheta imaginii.Ryot, de la „Roll Your Own Tracker” și pronunțat „riot”, păstrează într-un singur loc ce ați văzut, citit, jucat și antrenat, cu statistici, un calendar al noutăților care urmează și colecții proprii. Dezvoltatorul său, IgnisDa, îl scrie în Rust, cu o interfață web pe care o puteți instala pe telefon ca aplicație.
Ryot este publicat sub licența GNU General Public License, versiunea 3 (GPL-3.0). Îl puteți folosi gratuit, pentru dumneavoastră, familia, clubul sau firma dumneavoastră, îl puteți copia și modifica. Dacă distribuiți o versiune modificată, îi distribuiți și codul sursă sub aceeași licență. Software-ul este furnizat fără garanție.
Ryot Pro este o cheie plătită vândută de dezvoltator, care deblochează funcții suplimentare precum partajarea profilului și recomandările personalizate. Ea se pune într-o variabilă SERVER_PRO_KEY a aceleiași imagini, iar serverul revine la versiunea comunitară dacă cheia expiră. Nimic din acest ghid nu are nevoie de ea.
Documentația nu stabilește nicio dimensiune minimă, iar Ryot este ușor. Iată ce am măsurat pe VPS-ul nostru de test, proaspăt instalat:
Dimensiunea serverului depinde deci de numărul de utilizatori și de celelalte aplicații pe care le rulați alături de Ryot. Pe un Managed VPS, descrieți-ne utilizarea dumneavoastră și vă recomandăm dimensiunea potrivită.
Ryot este livrat ca o singură imagine, ignisda/ryot, publicată și ca ghcr.io/ignisda/ryot, care servește atât interfața, cât și API-ul pe portul 8000. Are nevoie de PostgreSQL 15 sau mai nou, rulat alături, în propriul container. Pe un server cu Docker Engine și pluginul său Compose, instalate din depozitul Docker pentru Ubuntu, creați un director precum /opt/ryot și puneți în el acest compose.yaml, realizat pe baza fișierului din pagina de instalare:
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:
Cele două secrete merg într-un fișier .env alăturat, pe care Docker Compose îl citește singur. Creați-l astfel încât să poată fi citit doar de root, apoi porniți ansamblul:
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: fișierul de referință îl publică fără adresă, iar Docker îl deschide atunci pe toate adresele serverului. Publicat local, el este accesibil doar prin proxy-ul invers.postgres ca utilizator și ca parolă. Aici, un utilizator dedicat ryot primește o parolă aleatorie, în hexazecimal, ca să nu necesite nicio escapare în DATABASE_URL.SERVER_ADMIN_ACCESS_TOKEN este obligatoriu: autorizează operațiile de administrator prin API și criptează secretele autentificării în doi pași ale utilizatorilor dumneavoastră. Păstrați-l secret și păstrați-l neschimbat: cu un alt token, acele secrete nu mai pot fi citite.FRONTEND_URL este adresa dumneavoastră publică, cu https://. Ryot o folosește ca bază pentru linkurile pe care le generează, iar OpenID Connect are nevoie de ea.TZ este fusul orar al sarcinilor programate, implicit GMT: puneți-l pe al dumneavoastră, din lista IANA.v10 cu pull_policy: always, ceea ce urmează fiecare versiune minoră la fiecare pornire. O versiune completă, aici v10.5.8, vă lasă să alegeți momentul fiecărei actualizări.postgres_storage păstrează toate datele dumneavoastră. PostgreSQL 18 le ține în /var/lib/postgresql, de aceea volumul este montat acolo și nu pe /var/lib/postgresql/data, ca la versiunile mai vechi.Prima pornire rulează migrările bazei de date și descarcă catalogul de exerciții; pe VPS-ul nostru de test, Ryot a răspuns în câteva secunde. Pentru a verifica dacă răspunde:
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
Prima comandă răspunde 200. A doua returnează configurația încărcată de server, în JSON, cu secretele mascate: un mod practic de a verifica o variabilă.
Containerul servește Ryot în HTTP, pe portul 8000. HTTPS revine unui proxy invers plasat în față, care trebuie să transmită antetul public Host și X-Forwarded-Proto. Am testat Caddy, instalat din depozitul său oficial pentru Debian și Ubuntu: obține singur certificatul Let’s Encrypt, îl reînnoiește și transmite implicit aceste antete.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.Ryot nu are niciun cont implicit, iar înregistrările sunt deschise pe o instanță nouă. Primul cont creat primește rolul Admin; următoarele sunt utilizatori obișnuiți. Creați-vă contul imediat după prima pornire:
Pentru o instanță privată, închideți înregistrările: adăugați USERS_ALLOW_REGISTRATION=false în mediul serviciului ryot, apoi rulați docker compose up -d. Pe VPS-ul nostru de test, linkul „Create a new account?” a dispărut, iar o înregistrare încercată de la adresa de înregistrare a fost refuzată de server cu „Registration is disabled”.
Am testat cu înregistrările închise: contul invitat a fost creat ca utilizator obișnuit, parola lui a fost setată din link și a ajuns pe propriul tablou de bord.
Pentru a vă conecta în schimb cu conturile firmei, Ryot acceptă OpenID Connect: setați SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET și SERVER_OIDC_ISSUER_URL, apoi declarați https://ryot.example.com/api/auth ca adresă de redirecționare la furnizorul dumneavoastră.
Ryot găsește detaliile și copertele fiecărui tip de media la un furnizor. Unii funcționează fără cheie, alții au nevoie de a dumneavoastră, deoarece cheile partajate au fost eliminate în v9:
| Media | Furnizor | Ce trebuie setat |
|---|---|---|
| Cărți | Open Library | Nimic: funcționează imediat. Google Books și Hardcover sunt opționale, cu cheia lor API |
| Filme și seriale | TMDB sau TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, API Read Access Token al unui cont TMDB gratuit, sau MOVIES_AND_SHOWS_TVDB_API_KEY |
| Jocuri video | IGDB, prin Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID și VIDEO_GAMES_TWITCH_CLIENT_SECRET, dintr-o aplicație din consola pentru dezvoltatori Twitch |
| Muzică | Spotify, opțional | MUSIC_SPOTIFY_CLIENT_ID și MUSIC_SPOTIFY_CLIENT_SECRET |
| Import anime | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, necesar doar pentru importul din MyAnimeList |
Aceste chei sunt secrete: puneți-le în fișierul .env, adăugați o linie precum - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} în mediul serviciului ryot, apoi rulați docker compose up -d. Pagina de configurare din documentație listează toate celelalte variabile.
Totul se află în două locuri: baza de date PostgreSQL, în volumul postgres_storage, și fișierul dumneavoastră .env. Păstrați-l pe acesta din urmă în siguranță: SERVER_ADMIN_ACCESS_TOKEN este necesar pentru a citi secretele de autentificare în doi pași stocate în baza de date. Imaginea PostgreSQL include pg_dump. Dumpul conține toate conturile și istoricul lor, așa că creați-l astfel încât să poată fi citit doar de root, cu umask 077 între paranteze: restul sesiunii dumneavoastră își păstrează masca obișnuită. Un fișier care există deja își păstrează permisiunile când este suprascris, așa că linia find închide mai întâi dumpurile și copiile aflate deja în director, înainte să se scrie ceva, și oprește backupul dacă nu reușește:
(
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
)
Programați această copie și trimiteți-o în afara serverului. Păstrate pe disc, dumpurile intră și în backupurile de noapte ale serverului.
Pe aceeași instalare sau pe una nouă, cu același .env, opriți aplicația, înlocuiți baza de date cu una goală, încărcați dumpul în ea, apoi porniți din nou aplicația:
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 oprește restaurarea la prima eroare, în loc să continue și să raporteze erorile la final, iar && opresc secvența acolo: Ryot rămâne oprit. Ce a fost încărcat înainte de eroare rămâne în baza de date, așa că, după ce ați remediat cauza, reluați de la dropdb.Am testat întregul ciclu pe VPS-ul nostru cu exact aceste comenzi: dump, baza de date ștearsă și creată din nou goală, restaurare. Cele două conturi, colecțiile lor și cele 876 de exerciții au revenit, iar administratorul s-a conectat din nou imediat.
Ryot exportă și propriile date în JSON, din pagina de setări „Imports and Exports”, și le poate importa din nou. Acest export are nevoie de o stocare de fișiere compatibilă S3; dumpul bazei de date de mai sus funcționează fără ea.
Ryot publică des versiuni noi, aproximativ săptămânal. Citiți notele versiunii, faceți un backup, schimbați eticheta imaginii în compose.yaml, apoi descărcați noua imagine și recreați containerul. Migrările bazei de date rulează singure la pornire:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop urmează ramura principală: documentația avertizează că are adesea erori majore și poate pierde date. Rămâneți la versiunile publicate.Ryot colectează date anonime de utilizare, vizualizări de pagini și câteva evenimente, pe o instanță Umami găzduită chiar de dezvoltator. Pentru a o dezactiva, adăugați DISABLE_TELEMETRY=true în mediul serviciului ryot, apoi rulați docker compose up -d.
Găzduirea pe propriul server cere să țineți serverul pe lângă aplicație. Pe un Managed VPS, echipele noastre preiau serverul și vă urmăresc proactiv instanța; Ryot rămâne software-ul dumneavoastră, cu istoricul și setările dumneavoastră.
| Subiect | Echipele noastre | Dumneavoastră |
|---|---|---|
| Serverul | Actualizări de sistem și de securitate, intervenții pe server incluse | Momentul care vă convine |
| Monitorizarea | Server urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelul | Istoricul, colecțiile și integrările dumneavoastră în Ryot |
| Ryot | Urmărire proactivă: erori, încetiniri, baza de date și spațiu pe disc depistate, corectură recomandată | Instalarea, actualizările, cheile API și setările sale, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI |
| Utilizatorii | Serverul care îi poartă, supravegheat și salvat | Conturile, înregistrările și autentificarea unică |
| Backupurile | În fiecare noapte, criptate și păstrate în afara mașinii; restaurare inclusă | Dumpurile bazei de date și exporturile JSON proprii Ryot, și cererea de restaurare, când aveți nevoie de ea |
| Migrarea | Serverul dumneavoastră actual migrat, gratuit | Momentul trecerii |
Dacă preferați ca echipele noastre să intervină în aplicația însăși, această prestație se facturează la oră sau la preț fix, cu o ofertă comunicată înainte de intervenție.
Cu un Managed VPS Simafri, echipele noastre țin la zi serverul instanței dumneavoastră Ryot, îl monitorizează zi și noapte și intervin fără a vă aștepta apelul; ele vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră sau asistentul dumneavoastră AI. Backupurile sunt criptate în fiecare noapte și păstrate în afara mașinii, restaurarea lor este inclusă, iar migrarea serverului actual este gratuită.
Da. Ryot este sub licență GPL-3.0: îl puteți rula pentru dumneavoastră, familia sau echipa dumneavoastră fără nicio licență de cumpărat. Ryot Pro este o cheie plătită opțională care adaugă funcții aceleiași imagini. Rămâne costul serverului pe care rulează.
Folosiți imaginea ignisda/ryot și PostgreSQL 18 într-un compose.yaml. Puneți parola bazei de date și SERVER_ADMIN_ACCESS_TOKEN într-un fișier .env, setați FRONTEND_URL la adresa dumneavoastră https, publicați portul 8000 pe 127.0.0.1, rulați docker compose up -d și puneți în față un proxy invers în HTTPS.
Nu există. Faceți clic pe Create a new account? în pagina de conectare: primul cont creat devine administrator. Setați apoi USERS_ALLOW_REGISTRATION=false pentru a închide înregistrările; administratorul îi invită pe ceilalți utilizatori din Settings, Users, cu un link de unică folosință.
Începând cu v9, filmele și serialele au nevoie de propriul dumneavoastră token TMDB: creați un cont TMDB gratuit, cereți o cheie API și puneți API Read Access Token al acesteia în MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Jocurile video au nevoie de o aplicație Twitch, în timp ce cărțile funcționează fără nicio cheie.
De puțină. Pe VPS-ul nostru de test, o instalare proaspătă folosea aproximativ 240 până la 300 MB pentru Ryot și 70 MB pentru PostgreSQL, iar cele două imagini ocupă aproximativ 810 MB pe disc.
Faceți dumpul bazei de date PostgreSQL cu docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot sub umask 077, ca să îl poată citi doar root, și păstrați o copie a fișierului .env. Pentru restaurare, opriți aplicația, recreați baza de date goală cu dropdb și createdb, apoi încărcați dumpul cu pg_restore --exit-on-error --no-owner.
Citiți notele versiunii și faceți un backup, schimbați eticheta imaginii în compose.yaml, apoi rulați docker compose pull și docker compose up -d. Migrările bazei de date rulează singure la pornire. Între versiunile majore, urmați pagina de migrare.
Un Managed VPS acoperă serverul: sistem, securitate, monitorizare și backupuri. Echipele noastre vă urmăresc proactiv și instanța și vă recomandă corecturile utile, pe care le aplicați dumneavoastră. O intervenție în aplicație se facturează la oră sau la preț fix.
Simafri
Să discutăm despre site-ul dumneavoastră
Povestiți-ne despre proiectul dumneavoastră în câteva cuvinte: vă vom răspunde rapid.
Mulțumim! Cererea dumneavoastră a fost trimisă. Vă vom răspunde în curând.
Preferați e-mailul? Scrieți-ne la support@simafri.com.