Backup e ripristino

XIQUIL include un sistema di backup integrato per proteggere i tuoi dati.

Backup automatico

XIQUIL puo eseguire backup automatici del database a intervalli regolari.

Configurazione

1. Vai in Impostazioni avanzate (solo admin)
2. Nella sezione Backup, configura:
   • Frequenza: ogni quante ore eseguire il backup
   • Retention: quanti backup conservare (i piu vecchi vengono eliminati)
   • Password (opzionale): per crittografare il backup con AES-256

Dove vengono salvati

I backup vengono salvati nel volume xiquil-backups, che corrisponde alla cartella /app/backups/ dentro il container. Se usi bind mount, li trovi nella cartella che hai specificato.

Formato dei file:

• Senza crittografia: backup_YYYYMMDD_HHMMSS.dump (formato pg_dump custom)
• Con crittografia: backup_YYYYMMDD_HHMMSS.dump.enc (AES-256-GCM)

Backup manuale

Puoi anche eseguire un backup manuale in qualsiasi momento:

1. Vai in Impostazioni avanzate > Backup
2. Clicca Esegui backup ora

Oppure da terminale:

docker compose exec db pg_dump -U xiquil -Fc xiquil > backup_manuale.dump

Ripristino

Dalla UI

1. Vai in Impostazioni avanzate > Backup
2. Nella lista dei backup disponibili, clicca Ripristina sul backup desiderato
3. Conferma (il database attuale verra sovrascritto)

Da terminale

# Ferma l'app (ma non il database)
docker compose stop app

# Ripristina il backup
docker compose exec -T db pg_restore -U xiquil -d xiquil --clean --if-exists < backup.dump

# Riavvia l'app
docker compose start app

Backup crittografato

Se il backup e crittografato, servira la password per ripristinarlo. La UI chiede la password automaticamente. Da terminale, devi prima decrittografare il file.

Nota

Importante: conserva la password di crittografia in un posto sicuro. Senza la password, un backup crittografato non e recuperabile.

Buone pratiche

• Abilita il backup automatico con frequenza giornaliera
• Testa il ripristino periodicamente per verificare che i backup funzionino
• Copia i backup fuori dal server — un backup sullo stesso disco del database non protegge da guasti hardware
• Usa la crittografia se i backup vengono copiati su servizi cloud o dispositivi condivisi
• Conserva almeno 7 backup per avere una settimana di cronologia

---

Domande frequenti

Il backup include gli allegati (PDF, immagini)? No. Il backup automatico salva solo il database. Gli allegati sono nel volume xiquil-data e vanno salvati separatamente (copia della cartella).

Posso usare un backup per migrare su un altro server? Si. Installa XIQUIL sul nuovo server, poi ripristina il backup. Copia anche il volume xiquil-data per gli allegati.

Quanto spazio occupa un backup? Dipende dalla quantita di dati. Un database con qualche centinaio di documenti occupa tipicamente pochi MB. Il formato pg_dump custom e gia compresso.