Aggiornamenti e backup

Aggiornare

closeyourit update

Scarica prima i file della versione nuova (compose.yml, Caddyfile, le impostazioni della coda e il comando closeyourit stesso): se non esistono si ferma e non cambia niente. Poi fa un backup, scarica la versione nuova, aggiorna il database e riparte. Se le immagini della versione nuova non si scaricano, o non risponde entro 3 minuti, torna da sola alla versione e ai file di prima e ti dice quale backup ripristinare se serve. Il backup fatto prima dell'aggiornamento resta in backups/.

Tornare indietro cambia la versione dell'app, non il database: le modifiche che la versione nuova ha già fatto al database restano. Se dopo la versione vecchia si comporta male, ripristina il backup fatto prima dell'aggiornamento.

Per una versione precisa: closeyourit update 1.4.0.

Cosa contiene il backup

Una copia del database principale si fa ogni notte alle 03:00. Le ultime 7 restano in /opt/closeyourit/backups/, leggibili solo da root; l'esito di ogni giro va in /var/log/closeyourit-backup.log.

Le due che contano:

• Le chiavi segrete. Senza il .env con cui è stata fatta l'installazione, i dati cifrati di un backup non si possono leggere. Tieni una copia di .env fuori dal server.
• I file caricati. Allegati e registrazioni delle sessioni sono file, non righe. O li tieni su S3 (AWS_S3_BUCKET, vedi Impostazioni) o copi tu il volume.

Fare e ripristinare il backup

closeyourit backup              # fa una copia adesso
closeyourit restore <file>      # riporta il database a una copia

<file> è il nome di un file in /opt/closeyourit/backups/, per esempio closeyourit-20261003-030000.dump.

restore ferma l'app, cancella il database attuale, lo ricrea dalla copia e riavvia l'app. Tutto quello che è stato scritto dopo quella copia si perde. Prima di fare qualsiasi cosa ti chiede di scrivere restore.

Tenere una copia altrove

Una copia sullo stesso server non sopravvive alla perdita del server. Per mandare ogni copia anche su Amazon S3, imposta in /opt/closeyourit/.env:

BACKUP_S3_BUCKET=my-backups
AWS_REGION=eu-central-1
AWS_ACCESS_KEY_ID=...
AWS_SECRET_ACCESS_KEY=...

Ogni copia va in s3://<bucket>/closeyourit/. Le copie su S3 CloseYourIt non le cancella: imposta una regola di scadenza sul bucket.

Spostarsi su un altro server

1. Sul server vecchio: closeyourit backup, poi copia in un posto sicuro il file più recente in backups/ e /opt/closeyourit/.env.
2. Sul server nuovo: installa la stessa versione (CLOSEYOURIT_VERSION=<versione>, vedi Installazione).
3. Nel nuovo .env sostituisci SECRET_KEY_BASE, le tre chiavi AR_ENCRYPTION_* e SECRET_ASSETS_MASTER_KEY con i valori del vecchio. Lascia POSTGRES_PASSWORD come l'ha scritto la nuova installazione. Copia anche le tue impostazioni: email, S3 (AWS_*: senza, allegati e registrazioni salvati lì non si aprono), GitHub, Telegram.
4. Metti il file di backup in /opt/closeyourit/backups/ e lancia closeyourit restore <file>.
5. Copia anche i file caricati, a meno che non siano su S3.
6. Punta il dominio al server nuovo.

Controllare l'installazione

closeyourit doctor

Altri comandi

Qualcosa non funziona? Vedi Risolvere i problemi.