Guida all'installazione

Primo accesso ed esercizio

Il primo amministratore, gli aggiornamenti, i backup, il coming soon e la politica di sicurezza.

Il primo amministratore

La registrazione è aperta solo a chi ha un codice invito, e i codici si generano nella console — che ancora nessuno può aprire. Il primo codice si genera sulla macchina stessa.

  1. Immagine: sul server, dalla radice del repository, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Cartella: in PowerShell, nella cartella, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Il comando stampa un codice nella forma XXXX-XXXX-XXXX; invite-code 5 ne stampa cinque.
  4. Sul portale fai clic su Accedi, poi su Crea account: inserisci il codice e registrati con l'email scritta in ADMINISTRATORS, poi confermala con il codice dell'email di verifica.
  5. Accedi: Diagnostica, in fondo a ogni pagina, apre la console, dove si generano gli altri codici invito.

Suggerimento Se l'email di verifica non arriva, controlla la password della casella: il servizio d'accesso dice all'avvio quando manca.

Aggiornare

Un aggiornamento sostituisce l'immagine e tiene i dati: stanno nel volume del container, che appartiene al progetto e non all'immagine.

  1. Sulla macchina di sviluppo, con il repository aggiornato, costruisci la nuova immagine: .\rebuild_container_release.ps1 -NoSeedData.
  2. Copiala sul server, verificala e caricala come la prima volta: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Avvia con lo stesso comando della prima volta: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d si accorge della nuova immagine e ricrea il container, con un'interruzione di pochi secondi.
  4. Apri la console sulla scheda Aggiornamento: dove una riga dice Aggiornamento disponibile, fai clic su Esegui aggiornamento — fino ad allora le funzioni dati di quel servizio restano spente.

Suggerimento Prima di ogni aggiornamento controlla nella diagnostica che le copie dei database siano a posto (la scheda «Copie dei database») e copia i file: l'aggiornamento dei database lavora su una copia e tiene l'originale finché la copia non è verificata, ma le copie sono la tua strada per tornare indietro.

Copie e ripristino

Ogni servizio tiene una copia continua dei database che gestisce — account, indici dei documenti, posta, chat — al più un secondo indietro, e la ripristina a qualunque istante degli ultimi sette giorni. I file veri e propri — documenti, allegati, anteprime — si scrivono una volta e non cambiano più: si copiano a parte, o stanno in un bucket S3.

  1. Porta le copie dei database fuori dalla macchina: registra una destinazione della classe backups su un bucket S3 o su un altro disco, e attivala.
  2. Immagine: copia i file, senza i database, mentre gira: docker run --rm -v merydion-prod-allinone_merydion_state:/d:ro -v "$PWD/files":/b alpine sh -c 'tar czf /b/files-$(date +%F).tgz -C /d --exclude="*.db" --exclude="*.db-*" --exclude=./backups --exclude=./restores .' scrive un archivio datato nella cartella files.
  3. Cartella: fermala con .\stop.ps1, copia per intero la cartella data, poi riavviala.
  4. Se un amministratore ha registrato un'altra destinazione per i file, copia la sua cartella nello stesso giro: i file nati dopo la sua attivazione stanno solo lì.
  5. Tieni le copie lontano dalla macchina che proteggono.

Suggerimento Per riportare un database o l'installazione intera a un istante, ferma l'installazione e usa merydion-storage copies restore (la procedura «Copie e ripristino» del runbook): scrive i database ripristinati in una cartella nuova, che poi prende il posto della vecchia.

Mettere il sito in coming soon

Il coming soon mostra a ogni visitatore solo una pagina d'anteprima mentre l'installazione si prepara: il portale, le app, Palatys e la console aspettano dietro di lei, anche per gli amministratori.

  1. Accedi come amministratore e apri https://merydion.example.com/coming-soon.html?enabled=true: la pagina conferma e il sito è in coming soon.
  2. Per riaccendere il sito apri https://merydion.example.com/coming-soon.html?enabled=false: dopo la conferma la pagina ti porta alla home.
  3. Se non hai fatto l'accesso, la pagina te lo chiede prima; a un account che non è amministratore lo dice, e non cambia nulla.
  4. Lo stato è il file site/coming-soon nella cartella dei dati: toglierlo riaccende il sito anche senza la pagina.

Suggerimento La pagina del coming soon esiste in inglese e in italiano; a un visitatore di un'altra lingua arriva quella inglese.

Accendere le statistiche di visita

Il sito può contare le visite con Google Analytics 4, chiedendo prima il consenso a ogni visitatore: finché un visitatore non accetta, non si carica niente di Google. Le statistiche restano spente finché l'installazione non indica il suo ID di misurazione, e la console d'amministrazione non le ha mai.

  1. In Google Analytics crea una proprietà e uno stream di dati web per l'indirizzo del sito, e copia il suo ID di misurazione (comincia con G-).
  2. Immagine: nel file .env accanto a docker-compose.yml aggiungi MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX e ricrea il container con docker compose up -d. Cartella: esporta la stessa variabile nella sessione prima di start.ps1.
  3. Apri il sito in una finestra privata: in basso a sinistra compare l'avviso sulle statistiche di visita, e in fondo a ogni pagina compare «Preferenze sui cookie».
  4. Per spegnere le statistiche svuota la variabile e ricrea il container: l'avviso sparisce, e i browser di chi aveva accettato smettono di caricare Google Analytics.

Suggerimento L'informativa privacy e quella sui cookie descrivono già le statistiche, in ogni lingua, per l'installazione che le accende. Nella proprietà imposta la conservazione dei dati che vuoi — Google tiene i dati di una visita al più 14 mesi — e lascia spenti i segnali di Google: il sito li spegne anche dalla sua parte.

Offrire il sito ai motori di ricerca

Ogni installazione dice ai motori di ricerca di non indicizzarla finché non accende l'indicizzazione: una copia del sito che non è quella ufficiale — un'installazione di prova, quella di un'organizzazione — non le fa mai concorrenza nei risultati. Gli indirizzi che le pagine, le anteprime e le mappe del sito dichiarano nominano il sito ufficiale, https://merydion.eu, e le pagine dell'account, la console e la pagina di un indirizzo che non esiste non entrano mai in un indice.

  1. Solo sull'installazione che serve il sito ufficiale. Immagine: nel file .env accanto a docker-compose.yml aggiungi MERYDION_SITE_INDEXING=1 e ricrea il container con docker compose up -d. Cartella: esporta la stessa variabile nella sessione prima di start.ps1.
  2. Verifica: curl -I https://merydion.eu/ non mostra più l'intestazione X-Robots-Tag: noindex, e https://merydion.eu/robots.txt indica https://merydion.eu/sitemap.xml.
  3. In Google Search Console e in Bing Webmaster Tools verifica il dominio con un record DNS e invia https://merydion.eu/sitemap.xml.
  4. Per togliere di nuovo il sito dai motori di ricerca svuota la variabile e ricrea il container: ogni risposta torna a dire noindex, e i motori lasciano le pagine alla visita successiva.

Suggerimento Un portale generato per un altro indirizzo imposta MERYDION_SITE_ORIGIN (per esempio https://www.example.com) quando lo si genera: gli indirizzi canonici, le alternative di lingua, le anteprime e le mappe del sito nominano allora quell'indirizzo. La pagina di un indirizzo che non esiste risponde nella lingua della sua cartella, con lo stato 404.

La Content-Security-Policy del portale

Le pagine del portale girano sotto una Content-Security-Policy stretta che manda il gateway: una pagina può usare solo i propri file, richieste alla propria origine, immagini anche da data: e blob:, e nessuna cornice di un altro sito. È ciò che impedisce a un frammento di markup intruso di eseguire codice. L'unica eccezione sono le statistiche di visita: le pagine che possono contare le visite ammettono anche gtag.js di Google, solo nel suo percorso, e la raccolta di Google Analytics, che si caricano solo dopo che un visitatore ha accettato.

  1. Un portale personalizzato con script o stili scritti dentro le pagine non funziona: script e stili vanno in file propri.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE e window.MERYDION_DIAGNOSTICS_BASE possono spostare una famiglia di richieste solo sotto un altro percorso della stessa origine; un indirizzo su un'altra origine si ignora, con un errore nella console del browser.
  3. Le pagine della console dell'installazione portano la politica senza l'eccezione delle statistiche e, in più, non si possono mostrare dentro una cornice.
  4. La politica vive in apps/portal-csp.mjs e nei tre Caddyfile, e un test le tiene uguali: si cambia insieme in tutti e quattro i posti.

Suggerimento Il modulo d'accesso del servizio d'identità e la pagina di rifiuto della console arrivano con una politica propria, ancora più stretta.

Torna alla guida

Produttività, made in Italy.

Porta l'intera suite al tuo team: semplice, sicura e completamente tua.