Installationsanleitung

Das Image auf einem Linux-Server

Image erstellen, Server vorbereiten und den Container auf Ihrer Domain starten.

Das Image erstellen

Das Image wird auf dem Entwicklungsrechner erstellt, mit Docker Desktop im Modus für Linux-Container, und kommt als Datei auf den Server: Der Server braucht weder eine Registry noch den Quellcode.

  1. Führen Sie im Stammverzeichnis des Repositorys .\rebuild_container_release.ps1 -NoSeedData aus: Es erstellt das Image, prüft, dass es keine Quellen und jeden kompilierten Teil enthält, startet es zum Test und speichert es als deploy\docker\merydion-allinone.tar mit seinem Fingerabdruck.
  2. Kopieren Sie das Image und seinen Fingerabdruck auf den Server, zum Beispiel mit scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. Prüfen Sie auf dem Server den Fingerabdruck und laden Sie das Image: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Tipp Ohne -NoSeedData packt der Build auch merydion-data.tar.gz mit den Daten des Entwicklungsrechners — einschließlich personenbezogener Daten und des privaten Schlüssels des Anmeldedienstes: Das ist nicht für eine neue Installation gedacht.

Den Server vorbereiten

Behalten Sie auf dem Server die Struktur des Repositorys bei: Die Compose-Datei findet ihre Nachbarn über relative Pfade. Die folgenden Dateien gehören dem Server, nie dem Image.

  1. Lassen Sie den DNS-Eintrag Ihrer Domain auf den Server zeigen und öffnen Sie die Ports 80 und 443 zum Internet.
  2. Tragen Sie in deploy/prod-allinone/Caddyfile eine echte E-Mail-Adresse im globalen Block ein: Let's Encrypt schreibt dorthin, bevor ein Zertifikat abläuft.
  3. Legen Sie deploy/prod-allinone/.env an mit MERYDION_DOMAIN=merydion.example.com und, damit die Bestätigungs-E-Mails verschickt werden, MERYDION_AUTH_SMTP_PASSWORD= gefolgt vom Passwort des Postfachs.
  4. Legen Sie SERVER_SECRETS.json im Stammverzeichnis des Repositorys an, nur für Sie lesbar (chmod 600): Dort stehen die übrigen Geheimnisse der Dienste, und ohne welche enthält sie { "services": {} } — ohne die Datei startet der Container nicht.
  5. Tragen Sie Ihre E-Mail-Adresse in ADMINISTRATORS im Stammverzeichnis des Repositorys ein.

Tipp Ein Geheimnis gehört nie in SERVER_CONFIGURATION.json, das versioniert ist und die geheimen Felder leer hält; die Variable eines Feldes hat Vorrang vor SERVER_SECRETS.json.

Den Container starten

Der Container enthält das Gateway, die Dienste, das Portal und die Apps. Er startet aus dem geladenen Image, ohne auf dem Server etwas zu erstellen.

  1. Im Stammverzeichnis des Repositorys: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Prüfen Sie, dass er läuft: docker compose -f deploy/prod-allinone/docker-compose.yml ps muss running anzeigen, nicht restarting.
  3. Beim ersten Aufruf holt Caddy das Zertifikat, was bis zu einer Minute dauert: Danach antwortet curl -sS https://merydion.example.com/health mit ok.
  4. Startet der Container ständig neu, hat ein Dienst angehalten und die anderen mitgerissen: Lesen Sie den Grund mit docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Tipp Videoanrufe auf diesem Server brauchen außerdem den UDP-Port des Mediendienstes und ein TURN-Relay: Das Runbook für einen einzelnen Knoten im Repository beschreibt die zusätzlichen Einstellungen.

Zurück zur Anleitung

Produktivität, made in Italy.

Bringen Sie die gesamte Suite in Ihr Team — einfach, sicher und ganz Ihre.