Orlok

Aggiornamento

Porta un'installazione a una nuova versione di Orlok in sicurezza.

Gli aggiornamenti sostituiscono i container e mantengono i dati: il database sta nel volume db-data e le migrazioni vengono applicate in automatico all'avvio dell'app.

Release con numero di versione, changelog e aggiornamenti guidati sono nella roadmap. Fino ad allora, le nuove versioni vengono consegnate come pacchetto di installazione aggiornato.

Prima di iniziare

  1. Leggi le note che accompagnano la nuova versione.
  2. Fai un backup del database e assicurati di avere ORLOK_SECRET_KEY.
  3. Prevedi una breve finestra di manutenzione: le conversazioni e i job in corso si interrompono mentre l'app si riavvia.

Aggiornamento

Sostituisci i file del pacchetto di installazione con quelli nuovi, mantenendo il tuo .env.production. Poi confrontalo con il nuovo .env.production.example: aggiungi le eventuali nuove impostazioni prima di avviare.

Ricostruisci e riavvia:

docker compose --env-file .env.production up -d --build

Segui l'avvio dell'app e l'applicazione delle migrazioni:

docker compose --env-file .env.production logs -f app

Quando l'app risponde di nuovo, accedi e controlla un ufficio, una conversazione e la wiki.

Aggiornare da una versione precedente al 5 ottobre 2026

Quella release ha reso personali i colleghi e le credenziali, e le sue migrazioni cancellano i dati che non hanno posto nel nuovo modello. Non esiste uno script di rollback: fai il backup con l'app ferma e conserva il pacchetto di installazione precedente, che insieme sono la strada per tornare indietro.

Cosa cambia:

  • vengono rimossi le credenziali d'ufficio, gli accessi e le policy dei colleghi, e i comandi che gli amministratori avevano consentito a tutti;
  • vengono rimossi anche i comandi che le persone avevano consentito per sempre, perché, trasformati in tipi di comando, consentirebbero più di quanto ogni persona ha approvato;
  • gli host restano, in un unico registro per l'installazione; a un nome usato in due uffici viene aggiunto il nome dell'ufficio;
  • i colleghi esistenti passano al primo amministratore, che riceve i profili che usano così continuano a rispondere, e le conversazioni che altre persone avevano con loro vengono cancellate.

Dopo l'aggiornamento, gli amministratori concedono i profili alle persone, e ogni persona aggiunge le proprie credenziali e crea i propri colleghi.

Se qualcosa va storto

Le migrazioni vanno solo avanti. Per tornare alla versione precedente, ferma l'installazione, ripristina il backup fatto prima dell'aggiornamento e avvia di nuovo il pacchetto di installazione precedente.