Ospitare Ryot su un VPS gestito: il vostro tracker di media e allenamenti

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.

Simon Vasconcelos Lee Di Pubblicato il 19 novembre 2026Lettura: 11 minuti

Tutte le guide

In breve

  1. La licenza GPL-3.0 permette di far girare Ryot per voi, per la vostra famiglia o per il vostro club senza alcuna licenza da acquistare; Ryot Pro, una chiave a pagamento, aggiunge funzioni alla stessa immagine.
  2. Installatelo con Docker Compose: l'immagine ignisda/ryot e PostgreSQL 18, con la porta 8000 pubblicata su 127.0.0.1 dietro un reverse proxy in HTTPS.
  3. Mettete la password del database e SERVER_ADMIN_ACCESS_TOKEN in un file .env, e impostate FRONTEND_URL sul vostro indirizzo pubblico.
  4. Il primo account che create diventa amministratore; impostate poi USERS_ALLOW_REGISTRATION=false per chiudere le registrazioni su un'istanza privata.
  5. I libri funzionano subito; film e serie richiedono un token TMDB, i videogiochi un'applicazione Twitch. Fate il backup con pg_dump, poi aggiornate cambiando il tag dell'immagine.

Cosa fa Ryot

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.

Cosa permette la licenza GPL-3.0

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.

Le risorse da prevedere

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.

L'installazione con Docker Compose

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:

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:

I due segreti vanno in un file .env accanto, che Docker Compose legge da solo. Createlo leggibile solo da root, poi avviate lo stack:

Terminale, in /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

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:

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

HTTPS: il reverse proxy

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.

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

Il primo account, le registrazioni e gli inviti

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:

  1. Aprite il vostro indirizzo: Ryot mostra la sua pagina di accesso.
  2. Cliccate su «Create a new account?», poi inserite un nome utente e due volte una password.
  3. Registratevi, poi accedete con le nuove credenziali: arrivate sulla dashboard, con un tour introduttivo.
  4. In «Settings», «Users», il vostro account compare con il ruolo Admin.

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

Invitare gli altri utenti

  1. In «Settings», «Users», cliccate sul pulsante + accanto al titolo.
  2. Inserite il nome utente della persona: Ryot crea l'account e mostra un link monouso.
  3. Inviate il link: la persona lo apre, sceglie una password, poi accede.

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.

Film, serie e giochi: le chiavi API

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:

MediaFornitoreCosa impostare
LibriOpen LibraryNiente: funziona subito. Google Books e Hardcover sono facoltativi, con la loro chiave API
Film e serieTMDB, o TVDBMOVIES_AND_SHOWS_TMDB_ACCESS_TOKEN, l'API Read Access Token di un account TMDB gratuito, o MOVIES_AND_SHOWS_TVDB_API_KEY
VideogiochiIGDB, tramite TwitchVIDEO_GAMES_TWITCH_CLIENT_ID e VIDEO_GAMES_TWITCH_CLIENT_SECRET, da un'applicazione nella console per sviluppatori di Twitch
MusicaSpotify, facoltativoMUSIC_SPOTIFY_CLIENT_ID e MUSIC_SPOTIFY_CLIENT_SECRET
Importazione di animeMyAnimeListANIME_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.

I backup

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:

Terminale, in /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
)

Pianificate questa copia e inviatela fuori dal server. Conservati sul disco, i dump rientrano anche nei backup notturni del server.

Il ripristino

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:

Terminale, in /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

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.

Gli aggiornamenti

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:

Terminale, in /opt/ryot
docker compose pull
docker compose up -d
docker compose logs ryot | grep -i migration

La telemetria

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.

Chi fa che cosa su un VPS gestito

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.

ArgomentoI nostri teamVoi
Il serverAggiornamenti del sistema e della sicurezza, interventi sul server compresiIl momento più adatto a voi
La supervisioneServer seguito 24 ore su 24, 7 giorni su 7, con intervento senza attendere la vostra chiamataLa vostra cronologia, le vostre collezioni e le vostre integrazioni in Ryot
RyotMonitoraggio proattivo: errori, rallentamenti, database e spazio su disco individuati, correzione raccomandataLa sua installazione, i suoi aggiornamenti, le chiavi API e le impostazioni, che applicate voi o il vostro assistente IA
Gli utentiIl server che li ospita, sorvegliato e salvatoGli account, le registrazioni e il single sign-on
I backupOgni notte, cifrati e conservati fuori dalla macchina; ripristino compresoI dump del database e le esportazioni JSON proprie di Ryot, e la richiesta di ripristino, quando ne avete bisogno
La migrazioneIl vostro server attuale migrato, in omaggioIl 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.

Ryot, su un server gestito per voi

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.

Scoprire i VPS gestiti

Domande frequenti

Ryot è gratuito?

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.

Come installare Ryot con Docker Compose?

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.

Quali sono le credenziali predefinite di Ryot?

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.

Perché Ryot non trova film o serie?

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.

Quanta memoria serve a Ryot?

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.

Come fare il backup di Ryot?

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.

Come aggiornare Ryot?

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 Ryot?

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.

Contattaci