Hostati Ryot na Managed VPS-u znači povijest onoga što gledate, čitate, igrate i dižete čuvati na poslužitelju koji je vaš, a koji naši timovi održavaju ažurnim i nadziru danju i noću. Ryot je slobodan alat otvorenog koda za praćenje, pod licencom GPL-3.0, za filmove, serije, knjige, igre, podcaste, glazbu i treninge. Ovaj vodič prati njegovu službenu Docker sliku u inačici v10.5.8, a svaku smo naredbu pokrenuli na Simafri VPS-u prije nego što smo ga napisali: instalaciju s Docker Composeom i PostgreSQL-om, HTTPS, prvi račun, API ključeve za svaku vrstu medija, sigurnosne kopije i ažuriranja.
Autor: Simon Vasconcelos Lee
Objavljeno 19. studenoga 2026.Vrijeme čitanja: 11 minuta
ignisda/ryot i PostgreSQL 18, s portom 8000 objavljenim na 127.0.0.1 iza obrnutog proxyja s HTTPS-om.SERVER_ADMIN_ACCESS_TOKEN u datoteku .env, a FRONTEND_URL postavite na svoju javnu adresu.USERS_ALLOW_REGISTRATION=false kako biste na privatnoj instanci zatvorili registracije.pg_dump, a zatim ažurirajte promjenom oznake slike.Ryot, od „Roll Your Own Tracker”, a izgovara se „riot”, na jednom mjestu čuva ono što ste gledali, čitali, igrali i trenirali, sa statistikama, kalendarom onoga što dolazi i vlastitim zbirkama. Njegov razvijatelj, IgnisDa, piše ga u Rustu, s web-sučeljem koje na telefon možete instalirati kao aplikaciju.
Ryot je objavljen pod licencom GNU General Public License, inačica 3 (GPL-3.0). Možete ga besplatno upotrebljavati, za sebe, svoju obitelj, svoj klub ili svoju tvrtku, kopirati ga i mijenjati. Ako distribuirate izmijenjenu inačicu, distribuirate i njezin izvorni kod pod istom licencom. Softver se isporučuje bez jamstva.
Ryot Pro je plaćeni ključ koji prodaje razvijatelj, a otključava dodatne značajke kao što su dijeljenje profila i personalizirane preporuke. Upisuje se u varijablu SERVER_PRO_KEY iste slike, a poslužitelj se vraća na inačicu zajednice ako ključ istekne. Ništa u ovom vodiču ga ne treba.
Dokumentacija ne postavlja minimalnu veličinu, a Ryot je lagan. Evo što smo izmjerili na našem testnom VPS-u, netom instaliranom:
Veličina poslužitelja stoga ovisi o broju korisnika i o drugim aplikacijama koje pokrećete pokraj Ryota. Na Managed VPS-u opišite nam kako ga upotrebljavate, a mi vam preporučujemo odgovarajuću veličinu.
Ryot se isporučuje kao jedna slika, ignisda/ryot, objavljena i kao ghcr.io/ignisda/ryot, koja na portu 8000 poslužuje i sučelje i API. Treba mu PostgreSQL 15 ili noviji, koji radi pokraj njega u vlastitom spremniku. Na poslužitelju s Docker Engineom i njegovim dodatkom Compose, instaliranima iz Dockerova repozitorija za Ubuntu, napravite mapu poput /opt/ryot i u nju stavite ovaj compose.yaml, izrađen na temelju datoteke sa stranice o instalaciji:
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:
Dvije tajne vrijednosti idu u datoteku .env pokraj nje, koju Docker Compose čita sam. Stvorite je tako da je može čitati samo root, a zatim pokrenite stog:
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: referentna datoteka objavljuje ga bez adrese, a Docker ga tada otvara na svim adresama poslužitelja. Objavljen lokalno, dostupan je samo preko obrnutog proxyja.postgres kao korisnika i lozinku. Ovdje namjenski korisnik ryot dobiva nasumičnu lozinku, heksadecimalnu kako je u DATABASE_URL ne bi trebalo escapirati.SERVER_ADMIN_ACCESS_TOKEN je obavezan: odobrava administratorske operacije preko API-ja i šifrira tajne dvofaktorske autentifikacije vaših korisnika. Čuvajte ga u tajnosti i ne mijenjajte ga: s drugim tokenom te se tajne više ne mogu pročitati.FRONTEND_URL je vaša javna adresa, s https://. Ryot je koristi kao osnovu poveznica koje generira, a treba je i OpenID Connect.TZ je vremenska zona zakazanih zadataka, zadano GMT: upišite svoju, s popisa IANA.v10 s pull_policy: always, što pri svakom pokretanju prati svako manje izdanje. Puna inačica, ovdje v10.5.8, omogućuje vam da sami odaberete trenutak svakog ažuriranja.postgres_storage čuva sve vaše podatke. PostgreSQL 18 drži ih u /var/lib/postgresql, zato je volumen montiran ondje, a ne na /var/lib/postgresql/data kao kod starijih inačica.Prvo pokretanje izvodi migracije baze podataka i preuzima katalog vježbi; na našem testnom VPS-u Ryot je odgovorio za nekoliko sekundi. Da biste provjerili odgovara li:
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
Prva naredba odgovara s 200. Druga vraća konfiguraciju koju je poslužitelj učitao, u formatu JSON, sa skrivenim tajnim vrijednostima: praktičan način za provjeru varijable.
Spremnik poslužuje Ryot preko HTTP-a, na portu 8000. HTTPS preuzima obrnuti proxy ispred njega, koji mora prosljeđivati javno zaglavlje Host i X-Forwarded-Proto. Isprobali smo Caddy, instaliran iz njegova službenog repozitorija za Debian i Ubuntu: sam pribavlja Let’s Encrypt certifikat, obnavlja ga i zadano prosljeđuje ta zaglavlja.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.Ryot nema zadani račun, a registracije su na novoj instanci otvorene. Prvi račun koji se stvori dobiva ulogu Admin; sljedeći su obični korisnici. Svoj račun stvorite odmah nakon prvog pokretanja:
Za privatnu instancu zatvorite registracije: dodajte USERS_ALLOW_REGISTRATION=false u okruženje usluge ryot, a zatim pokrenite docker compose up -d. Na našem testnom VPS-u poveznica „Create a new account?” je nestala, a pokušaj registracije s adrese za registraciju poslužitelj je odbio porukom „Registration is disabled”.
Isprobali smo to sa zatvorenim registracijama: pozvani račun stvoren je kao obični korisnik, njegova je lozinka postavljena preko poveznice i stigao je na vlastitu nadzornu ploču.
Da biste se umjesto toga prijavljivali računima svoje tvrtke, Ryot podržava OpenID Connect: postavite SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET i SERVER_OIDC_ISSUER_URL te kod svog pružatelja prijavite https://ryot.example.com/api/auth kao adresu za preusmjeravanje.
Ryot podatke i naslovnice za svaku vrstu medija pronalazi kod nekog pružatelja. Neki rade bez ključa, drugima treba vaš, jer su zajednički ključevi uklonjeni u v9:
| Mediji | Pružatelj | Što postaviti |
|---|---|---|
| Knjige | Open Library | Ništa: radi odmah. Google Books i Hardcover su neobavezni, s njihovim API ključem |
| Filmovi i serije | TMDB ili TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, API Read Access Token besplatnog TMDB računa, ili MOVIES_AND_SHOWS_TVDB_API_KEY |
| Videoigre | IGDB, preko Twitcha | VIDEO_GAMES_TWITCH_CLIENT_ID i VIDEO_GAMES_TWITCH_CLIENT_SECRET, iz aplikacije u Twitchovoj razvojnoj konzoli |
| Glazba | Spotify, neobavezno | MUSIC_SPOTIFY_CLIENT_ID i MUSIC_SPOTIFY_CLIENT_SECRET |
| Uvoz animea | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, potreban samo za uvoz iz MyAnimeLista |
Ti su ključevi tajne vrijednosti: stavite ih u datoteku .env, dodajte redak poput - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} u okruženje usluge ryot, a zatim pokrenite docker compose up -d. Stranica dokumentacije o konfiguraciji navodi sve ostale varijable.
Sve se nalazi na dva mjesta: u bazi PostgreSQL, u volumenu postgres_storage, i u vašoj datoteci .env. Potonju čuvajte na sigurnom: SERVER_ADMIN_ACCESS_TOKEN potreban je za čitanje dvofaktorskih tajni pohranjenih u bazi. Slika PostgreSQL sadrži pg_dump. Izvoz sadrži svaki račun i njegovu povijest, pa ga stvorite tako da ga može čitati samo root, s umask 077 unutar zagrada: ostatak vaše sesije zadržava uobičajenu masku. Datoteka koja već postoji pri prepisivanju zadržava svoja dopuštenja, pa redak find najprije zatvara izvoze i kopije koji su već u mapi, prije nego što se išta zapiše, i zaustavlja sigurnosno kopiranje ako to ne uspije:
(
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
)
Zakažite tu kopiju i šaljite je izvan poslužitelja. Postavljeni na disk, izvozi ulaze i u noćne sigurnosne kopije poslužitelja.
Na istoj ili novoj instalaciji, s istom datotekom .env, zaustavite aplikaciju, zamijenite bazu praznom, učitajte u nju izvoz, a zatim aplikaciju ponovno pokrenite:
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 zaustavlja vraćanje pri prvoj pogrešci, umjesto da nastavi i pogreške prijavi na kraju, a && ondje zaustavljaju niz: Ryot ostaje zaustavljen. Ono što je učitano prije pogreške ostaje u bazi, pa nakon otklanjanja uzroka krenite ponovno od dropdb.Cijeli smo ciklus isprobali na svom VPS-u upravo ovim naredbama: izvoz, baza izbrisana i ponovno stvorena prazna, vraćanje. Dva računa, njihove zbirke i 876 vježbi su se vratili, a administrator se odmah ponovno prijavio.
Ryot izvozi i vaše vlastite podatke u JSON, sa stranice postavki „Imports and Exports”, i može ih ponovno uvesti. Taj izvoz treba pohranu datoteka kompatibilnu s S3; gornji izvoz baze radi i bez nje.
Ryot izlazi često, otprilike svaki tjedan. Pročitajte bilješke uz izdanje, napravite sigurnosnu kopiju, promijenite oznaku slike u compose.yaml, a zatim preuzmite novu sliku i ponovno stvorite spremnik. Migracije baze podataka pri pokretanju se izvode same:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop prati glavnu granu: dokumentacija upozorava da često ima ozbiljne pogreške i da može izgubiti podatke. Ostanite na izdanjima.Ryot prikuplja anonimne podatke o upotrebi, preglede stranica i nekoliko događaja, na instanci Umamija koju razvijatelj sam hostira. Da biste je isključili, dodajte DISABLE_TELEMETRY=true u okruženje usluge ryot, a zatim pokrenite docker compose up -d.
Hostanje na vlastitom poslužitelju traži da uz aplikaciju održavate i poslužitelj. Na Managed VPS-u naši timovi preuzimaju poslužitelj i proaktivno prate vašu instancu; Ryot ostaje vaš softver, s vašom poviješću i vašim postavkama.
| Tema | Naši timovi | Vi |
|---|---|---|
| Poslužitelj | Ažuriranja sustava i sigurnosti, uključujući intervencije na poslužitelju | Trenutak koji vam odgovara |
| Nadzor | Poslužitelj pod nadzorom 24 sata dnevno, 7 dana u tjednu, s intervencijom bez čekanja vašeg poziva | Vaša povijest, vaše zbirke i vaše integracije u Ryotu |
| Ryot | Proaktivno praćenje: uočene pogreške, usporavanja, baza podataka i prostor na disku, preporučen ispravak | Njegova instalacija, ažuriranja, API ključevi i postavke, koje primjenjujete vi ili vaš AI asistent |
| Korisnici | Poslužitelj koji ih nosi, nadziran i sigurnosno kopiran | Računi, registracije i jedinstvena prijava |
| Sigurnosne kopije | Svake noći, šifrirane i čuvane izvan stroja; vraćanje uključeno | Izvozi baze i JSON izvozi specifični za Ryot te zahtjev za vraćanje, kada vam zatreba |
| Migracija | Vaš trenutačni poslužitelj migriran, besplatno | Trenutak prelaska |
Ako želite da naši timovi interveniraju u samoj aplikaciji, ta se usluga naplaćuje po satu ili paušalno, uz procjenu koja vam se priopćuje prije intervencije.
Uz Simafri Managed VPS naši timovi održavaju poslužitelj vaše instance Ryota ažurnim, nadziru ga danju i noću i interveniraju bez čekanja vašeg poziva; uz to proaktivno prate vašu instancu i preporučuju vam korisne ispravke, koje primjenjujete vi ili vaš AI asistent. Sigurnosne kopije svake se noći šifriraju i čuvaju izvan stroja, njihovo vraćanje je uključeno, a migracija vašeg trenutačnog poslužitelja je besplatna.
Da. Ryot je pod licencom GPL-3.0: možete ga pokretati za sebe, svoju obitelj ili svoj tim bez kupnje licence. Ryot Pro je neobavezni plaćeni ključ koji istoj slici dodaje značajke. Preostaje trošak poslužitelja na kojem radi.
Koristite sliku ignisda/ryot i PostgreSQL 18 u datoteci compose.yaml. Stavite lozinku baze podataka i SERVER_ADMIN_ACCESS_TOKEN u datoteku .env, postavite FRONTEND_URL na svoju https adresu, objavite port 8000 na 127.0.0.1, pokrenite docker compose up -d i ispred postavite obrnuti proxy s HTTPS-om.
Ne postoje. Na stranici za prijavu kliknite Create a new account?: prvi stvoreni račun postaje administrator. Zatim postavite USERS_ALLOW_REGISTRATION=false kako biste zatvorili registracije; administrator ostale korisnike poziva iz Settings, Users, jednokratnom poveznicom.
Od v9 filmovima i serijama treba vaš vlastiti TMDB token: stvorite besplatan TMDB račun, zatražite API ključ i njegov API Read Access Token upišite u MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. Videoigrama treba aplikacija na Twitchu, dok knjige rade bez ikakvog ključa.
Malo. Na našem testnom VPS-u nova je instalacija trošila oko 240 do 300 MB za Ryot i 70 MB za PostgreSQL, a dvije slike zauzimaju oko 810 MB diska.
Izvezite bazu PostgreSQL naredbom docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot pod umask 077, kako bi je mogao čitati samo root, i čuvajte kopiju svoje datoteke .env. Za vraćanje zaustavite aplikaciju, ponovno stvorite praznu bazu s dropdb i createdb, a zatim učitajte izvoz s pg_restore --exit-on-error --no-owner.
Pročitajte bilješke uz izdanje i napravite sigurnosnu kopiju, promijenite oznaku slike u compose.yaml, a zatim pokrenite docker compose pull i docker compose up -d. Migracije baze podataka pri pokretanju se izvode same. Između glavnih inačica slijedite stranicu o migraciji.
Managed VPS pokriva poslužitelj: sustav, sigurnost, nadzor i sigurnosne kopije. Naši timovi uz to proaktivno prate vašu instancu i preporučuju korisne ispravke, koje primjenjujete vi. Intervencija u aplikaciji naplaćuje se po satu ili paušalno.
Simafri
Porazgovarajmo o Vašem projektu
Recite nam u nekoliko riječi što trebate: javljamo Vam se brzo.
Hvala! Vaš upit je poslan. Javit ćemo vam se uskoro.
Više volite e-mail? Pišite nam na support@simafri.com.