Ospitare Ryot su un VPS gestito significa conservare la cronologia di ciò che guardate, leggete, giocate e sollevate in palestra su un server tutto vostro, che i nostri team tengono aggiornato e supervisionano giorno e notte. Ryot è un tracker libero con licenza GPL-3.0, per film, serie, libri, giochi, podcast, musica e allenamenti. Questa guida segue la sua immagine Docker ufficiale alla versione v10.5.8, e abbiamo eseguito ogni comando su un VPS Simafri prima di scriverla: l'installazione con Docker Compose e PostgreSQL, HTTPS, il primo account, le chiavi API di ogni tipo di media, i backup e gli aggiornamenti.
Di Simon Vasconcelos Lee
Pubblicato il 19 novembre 2026Lettura: 11 minuti
ignisda/ryot e PostgreSQL 18, con la porta 8000 pubblicata su 127.0.0.1 dietro un reverse proxy in HTTPS.SERVER_ADMIN_ACCESS_TOKEN in un file .env, e impostate FRONTEND_URL sul vostro indirizzo pubblico.USERS_ALLOW_REGISTRATION=false per chiudere le registrazioni su un'istanza privata.pg_dump, poi aggiornate cambiando il tag dell'immagine.Ryot, da «Roll Your Own Tracker» e pronunciato come «riot», riunisce in un solo posto ciò che avete visto, letto, giocato e allenato, con statistiche, un calendario delle uscite in arrivo e collezioni vostre. Il suo sviluppatore, IgnisDa, lo scrive in Rust, con un'interfaccia web che si installa su un telefono come un'app.
Ryot è pubblicato con la GNU General Public License, versione 3 (GPL-3.0). Potete usarlo gratuitamente, per voi, per la vostra famiglia, per il vostro club o per la vostra azienda, copiarlo e modificarlo. Se distribuite una versione modificata, ne distribuite il codice sorgente con la stessa licenza. Il software è fornito senza garanzia.
Ryot Pro è una chiave a pagamento venduta dal suo sviluppatore, che sblocca funzioni aggiuntive come la condivisione del profilo e i consigli personalizzati. Va in una variabile SERVER_PRO_KEY della stessa immagine, e il server torna alla versione community se la chiave scade. Nulla in questa guida ne ha bisogno.
La documentazione non fissa una dimensione minima, e Ryot è leggero. Ecco ciò che abbiamo misurato sul nostro VPS di test, appena installato:
La dimensione del server dipende quindi dal numero di utenti e dalle altre applicazioni che fate girare accanto a Ryot. Su un VPS gestito, descriveteci il vostro utilizzo e vi consiglieremo la dimensione giusta.
Ryot è distribuito come un'unica immagine, ignisda/ryot, pubblicata anche come ghcr.io/ignisda/ryot, che serve sia l'interfaccia sia l'API sulla porta 8000. Richiede PostgreSQL 15 o successivo, che gira accanto, nel suo container. Su un server con Docker Engine e il suo plugin Compose, installati dal repository di Docker per Ubuntu, create una cartella come /opt/ryot e metteteci questo compose.yaml, basato sul file della pagina di installazione:
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:
I due segreti vanno in un file .env accanto, che Docker Compose legge da solo. Createlo leggibile solo da root, poi avviate lo stack:
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: il file di riferimento la pubblica senza indirizzo, e Docker la apre allora su tutti gli indirizzi del server. Pubblicata in locale, è raggiungibile solo attraverso il reverse proxy.postgres come utente e come password. Qui un utente dedicato ryot riceve una password casuale, in esadecimale perché non richieda alcun escape in DATABASE_URL.SERVER_ADMIN_ACCESS_TOKEN è obbligatorio: autorizza le operazioni di amministrazione tramite l'API, e cifra i segreti dell'autenticazione a due fattori dei vostri utenti. Tenetelo segreto e tenetelo stabile: con un altro token, quei segreti non si possono più leggere.FRONTEND_URL è il vostro indirizzo pubblico, con https://. Ryot lo usa come base dei link che genera, e OpenID Connect ne ha bisogno.TZ è il fuso orario dei job pianificati, GMT per impostazione predefinita: mettete il vostro, dall'elenco IANA.v10 con pull_policy: always, che segue ogni versione minore a ogni avvio. Una versione completa, qui v10.5.8, vi lascia scegliere il momento di ogni aggiornamento.postgres_storage contiene tutti i vostri dati. PostgreSQL 18 li tiene in /var/lib/postgresql, ed è per questo che il volume è montato lì e non su /var/lib/postgresql/data come con le versioni precedenti.Il primo avvio esegue le migrazioni del database e scarica il catalogo degli esercizi; sul nostro VPS di test, Ryot rispondeva in pochi secondi. Per verificare che risponda:
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
Il primo comando risponde 200. Il secondo restituisce la configurazione caricata dal server, in JSON, con i segreti oscurati: un modo pratico per verificare una variabile.
Il container serve Ryot in HTTP, sulla porta 8000. HTTPS è affidato a un reverse proxy posto davanti, che deve inoltrare l'intestazione Host pubblica e X-Forwarded-Proto. Abbiamo testato Caddy, installato dal suo repository ufficiale per Debian e Ubuntu: ottiene da solo il certificato Let's Encrypt, lo rinnova, e inoltra queste intestazioni per impostazione predefinita.
ryot.example.com {
reverse_proxy 127.0.0.1:8000
}
sudo systemctl reload caddy
CADDY_TRUSTED_PROXIES.Ryot non ha alcun account predefinito, e le registrazioni sono aperte su una nuova istanza. Il primo account creato riceve il ruolo Admin; i successivi sono utenti normali. Create il vostro subito dopo il primo avvio:
Per un'istanza privata, chiudete le registrazioni: aggiungete USERS_ALLOW_REGISTRATION=false all'ambiente del servizio ryot, poi eseguite docker compose up -d. Sul nostro VPS di test, il link «Create a new account?» è scomparso, e una registrazione tentata dall'indirizzo di registrazione è stata rifiutata dal server con «Registration is disabled».
L'abbiamo testato con le registrazioni chiuse: l'account invitato è stato creato come utente normale, la sua password è stata impostata dal link, e ha raggiunto la propria dashboard.
Per accedere invece con gli account della vostra azienda, Ryot supporta OpenID Connect: impostate SERVER_OIDC_CLIENT_ID, SERVER_OIDC_CLIENT_SECRET e SERVER_OIDC_ISSUER_URL, e dichiarate https://ryot.example.com/api/auth come indirizzo di reindirizzamento presso il vostro provider.
Ryot trova le schede e le copertine di ogni tipo di media presso un fornitore. Alcuni funzionano senza chiave, altri richiedono la vostra, perché le chiavi condivise sono state rimosse nella v9:
| Media | Fornitore | Cosa impostare |
|---|---|---|
| Libri | Open Library | Niente: funziona subito. Google Books e Hardcover sono facoltativi, con la loro chiave API |
| Film e serie | TMDB, o TVDB | MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, l'API Read Access Token di un account TMDB gratuito, o MOVIES_AND_SHOWS_TVDB_API_KEY |
| Videogiochi | IGDB, tramite Twitch | VIDEO_GAMES_TWITCH_CLIENT_ID e VIDEO_GAMES_TWITCH_CLIENT_SECRET, da un'applicazione nella console per sviluppatori di Twitch |
| Musica | Spotify, facoltativo | MUSIC_SPOTIFY_CLIENT_ID e MUSIC_SPOTIFY_CLIENT_SECRET |
| Importazione di anime | MyAnimeList | ANIME_AND_MANGA_MAL_CLIENT_ID, necessario solo per importare da MyAnimeList |
Queste chiavi sono segreti: mettetele nel file .env, aggiungete una riga come - MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN=${MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN} all'ambiente del servizio ryot, poi eseguite docker compose up -d. La pagina di configurazione della documentazione elenca tutte le altre variabili.
Tutto si trova in due posti: il database PostgreSQL, nel volume postgres_storage, e il vostro file .env. Conservate quest'ultimo al sicuro: SERVER_ADMIN_ACCESS_TOKEN serve a leggere i segreti a due fattori memorizzati nel database. L'immagine di PostgreSQL include pg_dump. Il dump contiene ogni account e la sua cronologia, quindi createlo leggibile solo da root, con umask 077 tra parentesi: il resto della vostra sessione mantiene la sua maschera abituale. Un file che esiste già conserva i suoi permessi quando viene sovrascritto, quindi la riga find chiude prima i dump e le copie già presenti nella cartella, prima di scrivere qualsiasi cosa, e interrompe il backup se non ci riesce:
(
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
)
Pianificate questa copia e inviatela fuori dal server. Conservati sul disco, i dump rientrano anche nei backup notturni del server.
Sulla stessa installazione o su una nuova, con lo stesso .env, fermate l'applicazione, sostituite il database con uno vuoto, caricateci il dump, poi riavviate l'applicazione:
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 interrompe il ripristino al primo errore, invece di proseguire e segnalare gli errori alla fine, e gli && fermano la sequenza in quel punto: Ryot resta fermo. Ciò che è stato caricato prima dell'errore resta nel database, quindi ripartite da dropdb una volta corretta la causa.Abbiamo testato l'intero ciclo sul nostro VPS con questi comandi esatti: dump, database eliminato e ricreato vuoto, ripristino. I due account, le loro collezioni e gli 876 esercizi sono tornati, e l'amministratore ha effettuato di nuovo l'accesso subito.
Ryot esporta anche i vostri dati in JSON, dalla pagina delle impostazioni «Imports and Exports», e sa reimportarli. Quell'esportazione richiede uno storage di file compatibile S3; il dump del database descritto sopra funziona senza.
Ryot esce spesso, con un ritmo più o meno settimanale. Leggete le note di rilascio, fate un backup, cambiate il tag dell'immagine nel compose.yaml, poi scaricate la nuova immagine e ricreate il container. Le migrazioni del database partono da sole all'avvio:
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration
develop segue il ramo principale: la documentazione avverte che ha spesso bug importanti e può perdere dati. Restate sulle release.Ryot raccoglie dati di utilizzo anonimi, visualizzazioni di pagina e alcuni eventi, su un'istanza Umami self-hosted del suo sviluppatore. Per disattivarla, aggiungete DISABLE_TELEMETRY=true all'ambiente del servizio ryot, poi eseguite docker compose up -d.
Il self-hosting richiede di occuparsi del server oltre che dell'applicazione. Su un VPS gestito, i nostri team prendono in carico il server e seguono la vostra istanza in modo proattivo; Ryot resta il vostro software, con la vostra cronologia e le vostre impostazioni.
| Argomento | I nostri team | Voi |
|---|---|---|
| Il server | Aggiornamenti del sistema e della sicurezza, interventi sul server compresi | Il momento più adatto a voi |
| La supervisione | Server seguito 24 ore su 24, 7 giorni su 7, con intervento senza attendere la vostra chiamata | La vostra cronologia, le vostre collezioni e le vostre integrazioni in Ryot |
| Ryot | Monitoraggio proattivo: errori, rallentamenti, database e spazio su disco individuati, correzione raccomandata | La sua installazione, i suoi aggiornamenti, le chiavi API e le impostazioni, che applicate voi o il vostro assistente IA |
| Gli utenti | Il server che li ospita, sorvegliato e salvato | Gli account, le registrazioni e il single sign-on |
| I backup | Ogni notte, cifrati e conservati fuori dalla macchina; ripristino compreso | I dump del database e le esportazioni JSON proprie di Ryot, e la richiesta di ripristino, quando ne avete bisogno |
| La migrazione | Il vostro server attuale migrato, in omaggio | Il momento del passaggio |
Se preferite che i nostri team intervengano nell'applicazione stessa, questa prestazione si fattura a ore o a forfait, con un preventivo comunicato prima dell'intervento.
Con un VPS gestito Simafri, i nostri team tengono aggiornato il server della vostra istanza Ryot, lo sorvegliano giorno e notte e intervengono senza attendere la vostra chiamata; seguono anche la vostra istanza in modo proattivo e vi raccomandano le correzioni utili, che applicate voi o il vostro assistente IA. I backup sono cifrati ogni notte e conservati fuori dalla macchina, il loro ripristino è compreso e la migrazione del vostro server attuale è in omaggio.
Sì. Ryot ha licenza GPL-3.0: potete farlo girare per voi, per la vostra famiglia o per il vostro team senza alcuna licenza da acquistare. Ryot Pro è una chiave a pagamento facoltativa che aggiunge funzioni alla stessa immagine. Resta il costo del server che lo fa girare.
Usate l'immagine ignisda/ryot e PostgreSQL 18 in un compose.yaml. Mettete la password del database e SERVER_ADMIN_ACCESS_TOKEN in un file .env, impostate FRONTEND_URL sul vostro indirizzo https, pubblicate la porta 8000 su 127.0.0.1, eseguite docker compose up -d e mettete davanti un reverse proxy in HTTPS.
Non ce ne sono. Cliccate su «Create a new account?» nella pagina di accesso: il primo account creato diventa amministratore. Impostate poi USERS_ALLOW_REGISTRATION=false per chiudere le registrazioni; l'amministratore invita gli altri utenti da Settings, Users, con un link monouso.
Dalla v9, film e serie richiedono il vostro token TMDB: create un account TMDB gratuito, richiedete una chiave API e impostate il suo API Read Access Token in MOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN. I videogiochi richiedono un'applicazione Twitch, mentre i libri funzionano senza alcuna chiave.
Poca. Sul nostro VPS di test, una nuova installazione usava circa 240-300 MB per Ryot e 70 MB per PostgreSQL, e le due immagini occupano circa 810 MB di disco.
Fate il dump del database PostgreSQL con docker compose exec -T ryot-db pg_dump -U ryot -Fc ryot con umask 077, perché solo root possa leggerlo, e conservate una copia del vostro file .env. Per il ripristino, fermate l'applicazione, ricreate il database vuoto con dropdb e createdb, poi caricate il dump con pg_restore --exit-on-error --no-owner.
Leggete le note di rilascio e fate un backup, cambiate il tag dell'immagine in compose.yaml, poi eseguite docker compose pull e docker compose up -d. Le migrazioni del database partono da sole all'avvio. Tra versioni major, seguite la pagina sulla migrazione.
Un VPS gestito copre il server: sistema, sicurezza, supervisione e backup. I nostri team seguono anche la vostra istanza in modo proattivo e vi raccomandano le correzioni utili, che applicate voi. Un intervento nell'applicazione si fattura a ore o a forfait.
Simafri
Parliamo del vostro progetto
Diteci in due parole ciò che vi serve: vi rispondiamo rapidamente.
Grazie! La tua richiesta è stata inviata. Ti risponderemo a breve.
Preferite l'email? Scriveteci a support@simafri.com.