Guide d'installation

L'image sur un serveur Linux

Construisez l'image, préparez le serveur et démarrez le conteneur sur votre domaine.

Construire l'image

L'image se construit sur la machine de développement, avec Docker Desktop en mode conteneurs Linux, et arrive au serveur sous forme de fichier : le serveur n'a besoin ni d'un registre ni du code source.

  1. À la racine du dépôt, exécutez .\rebuild_container_release.ps1 -NoSeedData : il construit l'image, vérifie qu'elle ne contient aucune source et chaque partie compilée, la démarre pour essai et l'enregistre sous deploy\docker\merydion-allinone.tar avec son empreinte.
  2. Copiez l'image et son empreinte sur le serveur, par exemple avec scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. Sur le serveur, vérifiez l'empreinte et chargez l'image : cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Conseil Sans -NoSeedData, la build emballe aussi merydion-data.tar.gz avec les données de la machine de développement — données personnelles et clé privée du service de connexion comprises : ce n'est pas pour une nouvelle installation.

Préparer le serveur

Sur le serveur, gardez la disposition du dépôt : le fichier compose trouve ses voisins par chemin relatif. Les fichiers ci-dessous appartiennent au serveur, jamais à l'image.

  1. Faites pointer l'enregistrement DNS de votre domaine vers le serveur et ouvrez les ports 80 et 443 vers Internet.
  2. Dans deploy/prod-allinone/Caddyfile, écrivez une vraie adresse e-mail dans le bloc global : Let's Encrypt y écrit avant qu'un certificat expire.
  3. Créez deploy/prod-allinone/.env avec MERYDION_DOMAIN=merydion.example.com et, pour que les e-mails de vérification partent, MERYDION_AUTH_SMTP_PASSWORD= suivi du mot de passe de la boîte.
  4. Créez SERVER_SECRETS.json à la racine du dépôt, lisible par vous seul (chmod 600) : les autres secrets des services y vont, et s'il n'y en a aucun il contient { "services": {} } — sans le fichier, le conteneur ne démarre pas.
  5. Écrivez votre adresse e-mail dans ADMINISTRATORS, à la racine du dépôt.

Conseil Un secret ne va jamais dans SERVER_CONFIGURATION.json, qui est versionné et garde vides les champs secrets ; la variable d'un champ l'emporte sur SERVER_SECRETS.json.

Démarrer le conteneur

Le conteneur contient la passerelle, les services, le portail et les applications. Il démarre depuis l'image chargée, sans rien construire sur le serveur.

  1. À la racine du dépôt : docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Vérifiez qu'il tourne : docker compose -f deploy/prod-allinone/docker-compose.yml ps doit indiquer running, pas restarting.
  3. À la première visite, Caddy obtient le certificat, ce qui prend jusqu'à une minute : ensuite curl -sS https://merydion.example.com/health répond ok.
  4. Si le conteneur redémarre sans cesse, un service s'est arrêté et a entraîné les autres : lisez pourquoi avec docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Conseil Les appels vidéo sur ce serveur demandent aussi le port UDP du service média et un relais TURN : le runbook du nœud unique dans le dépôt décrit les réglages en plus.

Retour au guide

La productivité, made in Italy.

Offrez toute la suite à votre équipe : simple, sûre et entièrement à vous.