Aggiornamenti e backup

Verifica cosa è in esecuzione

curl http://localhost:3000/api/rest/app/version

Usa il tuo indirizzo se non è localhost:3000, o il tuo URL pubblico quando la porta non è pubblicata.

Aggiornare Vaultisse

Le versioni sono elencate nella pagina delle versioni e su GitHub.

1. Fai prima un backup. Vedi più sotto.

2. In .env, imposta APP_TAG sulla versione desiderata, per esempio APP_TAG=1.3.5.

3. Scarica la nuova immagine e riavvia:

   docker compose pull
   docker compose up -d

Le modifiche al database vengono applicate da sole. Quando una versione cambia il database, il server applica da sé i passaggi di aggiornamento mancanti all'avvio e ricorda quali ha già eseguito. Non c'è nulla da eseguire a mano, e un aggiornamento già applicato non viene mai ripetuto.

Suggerimento: Fissa APP_TAG a un numero di versione invece di latest. In questo modo un aggiornamento è una scelta tua, e non qualcosa che accade quando il contenitore si riavvia.

Per passare attraverso più versioni puoi saltare direttamente alla più recente: i passaggi di aggiornamento vengono eseguiti in ordine.

Provare una beta

Una versione preliminare come 1.3.7-beta.1 viene pubblicata con una propria etichetta di immagine e non è mai latest. Compare nella pagina delle versioni ed è segnata come prerelease su GitHub. Per provarla:

1. Fai prima un backup, e se possibile prova su una copia e non sulla biblioteca da cui dipendi. Una beta può cambiare il database in un modo che non si annulla tornando a una versione precedente. Ripristina il backup se vuoi uscirne.
2. Imposta APP_TAG=1.3.7-beta.1 in .env.
3. Esegui docker compose pull e docker compose up -d.

Per uscire dalla beta, ripristina il tuo backup e rimetti APP_TAG alla versione da cui venivi. Quando esce la versione finale, cambia APP_TAG con quella.

Fare il backup

Tutto ciò che conta è nel database. Due modi per proteggerlo:

Un file di dump (consigliato, funziona tra versioni diverse):

docker compose exec -T db pg_dump -U postgres vaultisse > vaultisse-$(date +%F).sql

Usa il tuo DB_USER e DB_NAME se li hai cambiati. Eseguilo in modo pianificato, per esempio con cron:

0 3 * * * cd /path/to/vaultisse && docker compose exec -T db pg_dump -U postgres vaultisse > /backups/vaultisse-$(date +\%F).sql

Copia i file anche fuori dalla macchina: un backup accanto ai dati va perso insieme a loro.

Il volume stesso: ferma lo stack e copia il volume db-data. Si ripristina solo sulla stessa versione maggiore di Postgres.

Conserva anche una copia del tuo .env. Senza JWT_SECRET e DB_PASSWORD puoi ripristinare i dati, ma tutti dovranno accedere di nuovo.

Nota: Anche i file ebook caricati sono salvati nel database, quindi fanno parte del dump.

Ripristinare

Su un'installazione nuova (passaggi 1 e 2 di Installazione), avvia solo il database, carica il dump e poi avvia l'app:

docker compose up -d db
docker compose exec -T db psql -U postgres -d vaultisse < vaultisse-2026-10-18.sql
docker compose up -d

Se il dump proviene da una versione precedente, il server lo aggiorna all'avvio.

Aggiornare PostgreSQL stesso

Cambiare il tag postgres: in docker-compose.yml con una nuova versione maggiore non è come aggiornare Vaultisse. Il formato dei dati cambia tra le versioni maggiori, quindi un volume esistente non si avvierà. Fai un dump, crea un volume nuovo e vuoto con la nuova versione e ripristina lì il dump.

Registri

docker compose logs -f app

Gli stessi messaggi sono scritti in bookStorage.log, nel volume app-logs. Attiva DEBUG_LOGGING=true solo mentre risolvi un problema: registra nomi e SQL e non deve restare attivo.