Găzduirea Ryot pe un Managed VPS: evidența media și fitness, pe propriul server

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.

Simon Vasconcelos Lee Autor: Publicat la 19 noiembrie 2026Timp de citire: 11 minute

Toate ghidurile

Esențialul

  1. Licența GPL-3.0 vă permite să rulați Ryot pentru dumneavoastră, familia sau clubul dumneavoastră fără nicio licență de cumpărat; Ryot Pro, o cheie plătită, adaugă funcții peste aceeași imagine.
  2. Instalați-l cu Docker Compose: imaginea ignisda/ryot și PostgreSQL 18, cu portul 8000 publicat pe 127.0.0.1 în spatele unui proxy invers în HTTPS.
  3. Puneți parola bazei de date și SERVER_ADMIN_ACCESS_TOKEN într-un fișier .env și setați FRONTEND_URL la adresa dumneavoastră publică.
  4. Primul cont pe care îl creați devine administrator; setați apoi USERS_ALLOW_REGISTRATION=false pentru a închide înregistrările pe o instanță privată.
  5. Cărțile funcționează imediat; filmele și serialele au nevoie de un token TMDB, jocurile video de o aplicație Twitch. Faceți backupul cu pg_dump, apoi actualizați schimbând eticheta imaginii.

Ce face Ryot

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.

Ce permite licența GPL-3.0

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.

Resursele de prevăzut

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

Instalarea cu Docker Compose

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:

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:

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:

Terminal, în directorul /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

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:

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

HTTPS: proxy-ul invers

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.

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

Primul cont, înregistrările și invitațiile

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:

  1. Deschideți adresa dumneavoastră: Ryot afișează pagina sa de conectare.
  2. Faceți clic pe „Create a new account?”, apoi introduceți un nume de utilizator și de două ori o parolă.
  3. Înregistrați-vă, apoi conectați-vă cu noile date de acces: ajungeți pe tabloul de bord, cu un tur de prezentare.
  4. În „Settings”, „Users”, contul dumneavoastră apare cu rolul Admin.

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

Invitarea celorlalți utilizatori

  1. În „Settings”, „Users”, faceți clic pe butonul + de lângă titlu.
  2. Introduceți numele de utilizator al persoanei: Ryot creează contul și afișează un link de unică folosință.
  3. Trimiteți linkul: persoana îl deschide, își alege o parolă, apoi se conectează.

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

Filme, seriale și jocuri: cheile API

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:

MediaFurnizorCe trebuie setat
CărțiOpen LibraryNimic: funcționează imediat. Google Books și Hardcover sunt opționale, cu cheia lor API
Filme și serialeTMDB sau TVDBMOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, API Read Access Token al unui cont TMDB gratuit, sau MOVIES_AND_SHOWS_TVDB_API_KEY
Jocuri videoIGDB, prin TwitchVIDEO_GAMES_TWITCH_CLIENT_ID și VIDEO_GAMES_TWITCH_CLIENT_SECRET, dintr-o aplicație din consola pentru dezvoltatori Twitch
MuzicăSpotify, opționalMUSIC_SPOTIFY_CLIENT_ID și MUSIC_SPOTIFY_CLIENT_SECRET
Import animeMyAnimeListANIME_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.

Backupurile

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:

Terminal, în directorul /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
)

Programați această copie și trimiteți-o în afara serverului. Păstrate pe disc, dumpurile intră și în backupurile de noapte ale serverului.

Restaurarea

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:

Terminal, în directorul /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

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.

Actualizările

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:

Terminal, în directorul /opt/ryot
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration

Telemetria

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.

Cine ce face pe un Managed VPS

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

SubiectEchipele noastreDumneavoastră
ServerulActualizări de sistem și de securitate, intervenții pe server incluseMomentul care vă convine
MonitorizareaServer urmărit 24 de ore din 24, 7 zile din 7, cu intervenție fără a vă aștepta apelulIstoricul, colecțiile și integrările dumneavoastră în Ryot
RyotUrmă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
UtilizatoriiServerul care îi poartă, supravegheat și salvatConturile, î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
MigrareaServerul dumneavoastră actual migrat, gratuitMomentul 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.

Ryot, pe un server întreținut pentru dumneavoastră

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

Descoperiți gama Managed VPS

Întrebări frecvente

Este Ryot 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ă.

Cum se instalează Ryot cu Docker Compose?

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.

Care sunt datele de acces implicite ale Ryot?

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

De ce nu găsește Ryot filme sau seriale?

Î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 câtă memorie are nevoie Ryot?

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.

Cum se face backupul pentru Ryot?

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.

Cum se actualizează Ryot?

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.

Acoperă un Managed VPS și Ryot?

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.

Surse și documentație oficială

Ghiduri conexe

PostgreSQL pe un VPS: cum dimensionați memoria și disculO bază PostgreSQL rapidă este o bază ale cărei date consultate des încap în memorie. Întreaga dimensionare pornește de aici: volumul bazei, partea care lucrează cu adevărat, numărul de conexiuni, apoi discul și marja lui. Acest ghid prezintă metoda, setările de pornire pentru 4, 8 și 16 GB de memorie și interogările care măsoară o bază existentă.Backupurile unui VPS: ce trebuie să verificați înainte de a semnaO ofertă de VPS anunță aproape mereu „backupuri incluse”. În spatele acestor două cuvinte se poate afla o copie făcută în fiecare noapte, păstrată în afara mașinii și restaurată de experți, sau un snapshot pus pe același disc ca serverul. Acest ghid prezintă întrebările care fac diferența, ce înseamnă fiecare răspuns și modul de a verifica faptul că un backup se poate restaura.Găzduirea Actual Budget pe un Managed VPS: bugetele pe propriul serverGăzduirea Actual Budget pe un Managed VPS înseamnă să păstrați bugetele și sincronizarea lor pe o mașină a dumneavoastră, pe care echipele noastre o țin la zi și o supraveghează zi și noapte. Actual Budget este un instrument de finanțe personale de tip local-first, publicat sub licență MIT. Acest ghid urmează documentația sa oficială: rolul serverului, instalarea cu Docker Compose, HTTPS, parola serverului, OpenID, criptarea end-to-end, sincronizarea bancară, backupurile și actualizările.
Contactați-ne