Guida all'installazione

L'immagine su un server Linux

Costruisci l'immagine, prepara il server e avvia il container sul tuo dominio.

Costruire l'immagine

L'immagine si costruisce sulla macchina di sviluppo, con Docker Desktop in modalità container Linux, e arriva al server come file: al server non servono né un registry né il codice sorgente.

  1. Dalla radice del repository esegui .\rebuild_container_release.ps1 -NoSeedData: costruisce l'immagine, verifica che non contenga sorgenti e che ci sia ogni parte compilata, la avvia per prova e la salva come deploy\docker\merydion-allinone.tar con la sua impronta.
  2. Copia l'immagine e la sua impronta sul server, per esempio con scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. Sul server verifica l'impronta e carica l'immagine: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Suggerimento Senza -NoSeedData la build impacchetta anche merydion-data.tar.gz con i dati della macchina di sviluppo — dati personali e chiave privata del servizio d'accesso compresi: non è per un'installazione nuova.

Preparare il server

Sul server mantieni la disposizione del repository: il file compose trova i suoi vicini per percorso relativo. I file qui sotto sono del server, mai dell'immagine.

  1. Fai puntare al server il record DNS del tuo dominio e apri verso Internet le porte 80 e 443.
  2. In deploy/prod-allinone/Caddyfile scrivi un'email vera nel blocco globale: Let's Encrypt ci scrive prima che un certificato scada.
  3. Crea deploy/prod-allinone/.env con MERYDION_DOMAIN=merydion.example.com e, perché le email di verifica partano, MERYDION_AUTH_SMTP_PASSWORD= seguito dalla password della casella.
  4. Crea SERVER_SECRETS.json alla radice del repository, leggibile solo da te (chmod 600): lì vanno gli altri segreti dei servizi, e se non ce ne sono contiene { "services": {} } — senza il file il container non parte.
  5. Scrivi la tua email in ADMINISTRATORS, alla radice del repository.

Suggerimento Un segreto non va mai in SERVER_CONFIGURATION.json, che è versionato e tiene vuoti i campi segreti; la variabile di un campo vince su SERVER_SECRETS.json.

Avviare il container

Il container contiene il gateway, i servizi, il portale e le app. Parte dall'immagine caricata, senza costruire nulla sul server.

  1. Dalla radice del repository: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Controlla che giri: docker compose -f deploy/prod-allinone/docker-compose.yml ps deve dire running, non restarting.
  3. Alla prima visita Caddy ottiene il certificato, e ci vuole fino a un minuto: poi curl -sS https://merydion.example.com/health risponde ok.
  4. Se il container continua a ripartire, un servizio si è fermato e ha portato con sé gli altri: leggi perché con docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Suggerimento Le videochiamate su questo server chiedono anche la porta UDP del servizio media e un relay TURN: il runbook del nodo singolo nel repository descrive le impostazioni in più.

Torna alla guida

Produttività, made in Italy.

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