Come self-hostare Hoard con Docker
Aggiornato 2026-10-30
Hoard è open source e self-hostabile. Invece di usare Hoard One, puoi eseguire lo stesso hoard-server sulla tua macchina e puntarci ogni dispositivo — senza account e senza limiti di spazio oltre al disco che gli dai. Questa guida mette in piedi un server con Docker in pochi minuti.
Perché self-hostare Hoard
- Controllo totale. I tuoi salvataggi vivono su hardware che controlli tu, non sul cloud altrui.
- Nessun limite. Lo spazio è limitato solo dal tuo disco.
- Stessa app, stesse funzioni. Sync in background e cronologia versionata funzionano come con Hoard One, con un'impostazione predefinita tutta sua: il server sfoltisce le versioni vecchie col tempo (più sotto i dettagli).
- Open source. Puoi leggere, verificare e modificare il server.
È la differenza chiave rispetto a strumenti come Ludusavi: Ludusavi è ottimo per i backup locali e per il cloud «porta il tuo» tramite Rclone, ma la sincronizzazione la configuri tu. Hoard ti dà un server di sync gestito che avvii una volta e a cui si collega ogni dispositivo.
Cosa significa il self-hosting per i tuoi dati
Vale la pena dirlo chiaramente, perché è il punto su cui quasi tutti i confronti sbagliano riguardo a Hoard.
Hoard One è l'opzione gestita, quella che consigliamo a tutti: accedi e i tuoi salvataggi stanno sui nostri server, nell'UE.
Un Hoard self-hosted è interamente tuo. I tuoi dispositivi parlano con il tuo server e con nient'altro. Nessun account con noi, nessuna telemetria verso di noi, nessuna quota e nessun relay: non passa nulla dai nostri server, perché sul percorso non c'è niente di nostro. Non possiamo vedere un salvataggio, il nome di un gioco o un indirizzo email, per il semplice motivo che niente di tutto ciò ci arriva. Se Hoard One chiudesse domani, la tua installazione andrebbe avanti identica.
Una precisazione, per essere esatti: il tuo server ha eccome i suoi accessi — l'utente che crei più sotto e un token per dispositivo. Sono tuoi, sulla tua macchina, nel tuo database. Quello che non esiste è un account con noi.
Cosa ti serve
- Una macchina sempre accesa (un server domestico, un NAS che esegue Docker o un piccolo VPS).
- Docker e Docker Compose installati (su un NAS Synology, il pacchetto Container Manager).
- Facoltativamente un dominio e un reverse proxy per l'HTTPS (consigliato per tutto ciò che esce dalla rete locale).
Installazione con Docker Compose
Non serve clonare il repository. Il server è un'immagine già pronta (ghcr.io/rleeon/hoard, amd64 e arm64), e l'unico file da scaricare è il suo docker-compose.yml:
mkdir hoard && cd hoard
curl -O https://raw.githubusercontent.com/rleeon/hoard/main/deploy/docker/docker-compose.yml
# Used only on the first start: they create that admin and print a device token in the log, once
HOARD_ADMIN_USERNAME=alice HOARD_ADMIN_PASSWORD='CHANGE_ME' docker compose up -d
docker compose logs -f server # wait for "listening", then copy the token
Al primo avvio il container scrive un config.toml funzionante in ./config/, accanto al file compose, quindi con un semplice docker compose non c'è niente da preparare. I dati vivono in un volume Docker (hoard-data): eseguine il backup come per qualsiasi volume. Il container ascolta internamente sulla porta 12421; usa un'altra porta host con HOARD_PORT=9000 docker compose up -d.
Preferisci leggere la configurazione prima che parta qualcosa, o compilare l'immagine da te? La guida al self-hosting nel repository spiega come clonarlo.
Su un NAS Synology (Container Manager)
Container Manager non ha una riga di comando da cui passare quelle due variabili, e si rifiuta di avviare un progetto finché manca una cartella montata: è l'errore Bind mount failed: '…/config' does not exist. Quattro passaggi risolvono entrambe le cose:
In File Station, crea una cartella per Hoard (per esempio
docker/hoard) e, al suo interno, una cartellaconfigvuota.In Container Manager, apri Project → Create, imposta quella cartella come percorso, scegli di creare un
docker-compose.ymle incolla il contenuto del file (per ottenerlo, apri nel browser l'URL della rigacurlqui sopra).Nel file incollato, sostituisci
${HOARD_ADMIN_USERNAME:-}e${HOARD_ADMIN_PASSWORD:-}con nome utente e password del tuo amministratore, lasciando il resto di ogni riga com'è, in modo che le due righe diventino:HOARD_ADMIN_USERNAME: alice HOARD_ADMIN_PASSWORD: 'CHANGE_ME'Completa la procedura guidata per avviarlo, poi apri il log di
hoard-serverin Container: il token del dispositivo è stampato lì, una sola volta.
Con il file così com'è, i salvataggi vivono nello spazio di archiviazione di Docker, fuori dalle tue cartelle condivise. Per tenerli in una cartella condivisa di cui fai già il backup, crea anche una cartella data accanto a config e cambia la riga hoard-data:/var/lib/hoard in ./data:/var/lib/hoard.
Crea il tuo utente e un token dispositivo
Se l'hai avviato con HOARD_ADMIN_USERNAME e HOARD_ADMIN_PASSWORD, è già fatto: l'utente esiste e il suo token è nel log. Altrimenti creali da riga di comando, perché il server non ha una schermata di registrazione:
docker compose exec server hoard-admin --config /etc/hoard/config.toml \
user create alice --admin --password 'CHANGE_ME'
docker compose exec server hoard-admin --config /etc/hoard/config.toml \
token create alice --device 'desktop'
Il token viene mostrato una sola volta e non può essere recuperato in seguito, quindi copialo ora. Per ogni dispositivo che aggiungi in seguito non serve un terminale: apri l'indirizzo del server nel browser, accedi al pannello web con quel nome utente e quella password e usa Utenti → Nuovo token.
Collega l'app desktop
Installa l'app desktop di Hoard su ogni macchina. Nella procedura iniziale scegli Self-Host, poi incolla l'URL del server e il token appena creato. Da lì si comporta esattamente come Hoard One: rileva i giochi, salva automaticamente e mantiene la cronologia versionata. Vedi sincronizzare i salvataggi tra più PC per l'uso quotidiano.
Tieni aggiornato il tuo server
Come si aggiorna dipende da come l'hai installato, e sbagliare comando non dà errore: semplicemente non fa nulla. Vale la pena sapere qual è il tuo caso.
Docker Compose. Scarica la nuova immagine e ricrea il container. Entrambe le metà, in quest'ordine:
docker compose pull
docker compose up -d
Se ti fermi alla prima, il vecchio container continua a girare intatto: /v1/health riporta ancora la versione precedente e l'aggiornamento sembra fallito in silenzio. git pull non aggiorna né l'uno né l'altro: quello che gira è l'immagine pubblicata, non la tua copia del repository. Fissa una versione (ghcr.io/rleeon/hoard:1.1) al posto di :latest se preferisci scegliere tu quando ne arriva una nuova.
Synology (Container Manager). Una volta sola: nello YAML del progetto, sostituisci la riga image: con queste due. È la stessa immagine, replicata su Docker Hub, e i tuoi dati restano dove sono.
image: rleeon/hoard:latest
pull_policy: always
Container Manager mostra Update available solo per le immagini :latest di Docker Hub, e da solo Build riusa l'immagine già su disco, quindi eliminare il container e ricostruirlo non cambia nulla. Con queste due righe, aggiornare significa Stop e poi Build.
Unraid. Scheda Docker → Hoard → Apply update quando compare. Niente da digitare.
Bare metal (systemd). sudo hoard-server upgrade, poi sudo systemctl restart hoard-server. Sostituisce il binario in modo atomico e di proposito non riavvia il servizio da solo, per non troncare una sincronizzazione in corso.
hoard-server upgrade vale solo per l'installazione bare metal. Dentro un container si rifiuta di proposito — la sostituzione del binario non sopravvivrebbe al prossimo docker compose up -d — e stampa i due comandi qui sopra; esegui docker compose exec server hoard-server upgrade se vuoi sentirglielo dire. Le migrazioni del database le applica il server all'avvio, quindi non c'è mai un passaggio separato.
Quanta cronologia conserva
Hoard One conserva tutte le versioni. Un server self-hosted, così com'è, sfoltisce quelle vecchie: la cronologia recente resta completa e quella più vecchia si dirada. Con l'impostazione predefinita tiene le 15 versioni più recenti di ogni gioco e poi l'ultima di ciascuna delle 19 ore, degli 11 giorni e delle 6 settimane più recenti in cui hai giocato. Le versioni più vecchie vengono eliminate, tranne quelle fissate e la più recente di ogni gioco, e una versione eliminata resta 30 giorni nel cestino del server prima di sparire del tutto.
Per tenere tutto, imposta snapshot_pruning = false nella sezione [retention] di config.toml (in ./config/, accanto al file compose) e riavvia il server (docker compose restart con Docker). Nella stessa sezione, data_saving sposta l'equilibrio: 0.0 tiene quasi tutto, 1.0 solo l'essenziale.
In produzione
Per tutto ciò che è esposto oltre la rete locale, termina il TLS su un reverse proxy (Caddy, nginx o Traefik). Preferisci il bare metal? Il repository include anche uno script di installazione systemd e un comando hoard-server upgrade che sostituisce il binario in modo atomico senza interrompere una sync in corso.
Self-host o Hoard One?
Il self-hosting è ideale se hai già un server e vuoi controllo totale senza limiti. A tutti gli altri consigliamo Hoard One: la stessa sincronizzazione, gestita da noi, con un piano gratuito per iniziare. In ogni caso app e salvataggi restano portabili: puoi cambiare in seguito.
Domande frequenti
Un Hoard self-hosted comunica con voi?
No. L'app desktop parla con l'indirizzo del server che le indichi tu. I tuoi salvataggi, i tuoi utenti e i tuoi log restano sulla tua macchina, e niente di tutto ciò ci arriva.
Il server self-hosted è lo stesso codice di Hoard One?
Sì, lo stesso codice di hoard-server, sotto AGPL-3.0. La versione ospitata aggiunge ciò che serve solo a un servizio pubblico, come registrazione, piani e pagamenti; tutto ciò che trova, sincronizza e versiona i tuoi salvataggi è in comune. Non c'è una community edition ridotta.
Dove finiscono davvero i salvataggi?
Per impostazione predefinita nel volume Docker che assegni al container, sul tuo disco. Se hai già uno storage a oggetti, il server parla anche S3: MinIO, Garage o Backblaze B2 vanno bene come archivio. In ogni caso i tuoi dispositivi parlano soltanto con il tuo server.
Posso farlo girare su un NAS?
Sì, su qualsiasi NAS che esegua Docker. Su Synology segui i passaggi per Container Manager qui sopra; per Unraid il repository include un template. In entrambi i casi l'immagine scende ai PUID/PGID che indichi, così le cartelle montate risultano dell'utente giusto e non di root.
Servono un dominio e HTTPS?
Sulla tua rete locale no. Non appena il server è raggiungibile dall'esterno, mettici davanti un reverse proxy e termina lì il TLS: vanno bene Caddy, nginx o Traefik.
E se il server è spento quando smetto di giocare?
Lo snapshot viene preso in locale, quindi non si perde nulla. Sale da solo appena il server torna a rispondere.
Posso iniziare con Hoard One e spostarmi dopo?
Sì, in entrambe le direzioni. Puoi esportare tutto dalla pagina del tuo account, e l'app può essere puntata su un altro server senza reinstallare niente.
Pronto a proteggere e sincronizzare i tuoi salvataggi?
Scarica Hoard: backup automatici con cronologia e salvataggi sincronizzati su tutti i tuoi dispositivi, pronto in un paio di minuti.
Scarica