Installationsguide

Avbilden på en Linux-server

Bygg avbilden, förbered servern och starta containern på din domän.

Bygg avbilden

Avbilden byggs på utvecklingsdatorn, med Docker Desktop i läget för Linux-containrar, och kommer till servern som en fil: servern behöver varken ett register eller källkoden.

  1. Kör .\rebuild_container_release.ps1 -NoSeedData i roten av förrådet: det bygger avbilden, kontrollerar att den inte innehåller källkod och att varje kompilerad del finns, startar den på prov och sparar den som deploy\docker\merydion-allinone.tar med dess fingeravtryck.
  2. Kopiera avbilden och dess fingeravtryck till servern, till exempel med scp deploy/docker/merydion-allinone.tar* admin@merydion.example.com:/tmp/.
  3. Kontrollera fingeravtrycket på servern och läs in avbilden: cd /tmp && sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.

Tips Utan -NoSeedData packar bygget även merydion-data.tar.gz med utvecklingsdatorns data — inklusive personuppgifter och inloggningstjänstens privata nyckel: det är inte för en ny installation.

Förbered servern

Behåll förrådets struktur på servern: compose-filen hittar sina grannar via relativa sökvägar. Filerna nedan hör till servern, aldrig till avbilden.

  1. Låt DNS-posten för din domän peka på servern och öppna portarna 80 och 443 mot internet.
  2. Skriv en riktig e-postadress i det globala blocket i deploy/prod-allinone/Caddyfile: Let's Encrypt skriver dit innan ett certifikat går ut.
  3. Skapa deploy/prod-allinone/.env med MERYDION_DOMAIN=merydion.example.com och, så att verifieringsmejlen skickas, MERYDION_AUTH_SMTP_PASSWORD= följt av brevlådans lösenord.
  4. Skapa SERVER_SECRETS.json i roten av förrådet, läsbar bara för dig (chmod 600): tjänsternas övriga hemligheter hör hemma där, och utan några innehåller den { "services": {} } — utan filen startar inte containern.
  5. Skriv din e-postadress i ADMINISTRATORS i roten av förrådet.

Tips En hemlighet hör aldrig hemma i SERVER_CONFIGURATION.json, som är versionshanterad och håller de hemliga fälten tomma; ett fälts variabel går före SERVER_SECRETS.json.

Starta containern

Containern innehåller gatewayen, tjänsterna, portalen och apparna. Den startar från den inlästa avbilden, utan att bygga något på servern.

  1. I roten av förrådet: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d.
  2. Kontrollera att den körs: docker compose -f deploy/prod-allinone/docker-compose.yml ps ska visa running, inte restarting.
  3. Vid första besöket hämtar Caddy certifikatet, vilket tar upp till en minut: sedan svarar curl -sS https://merydion.example.com/health ok.
  4. Om containern startar om hela tiden har en tjänst stannat och dragit med sig de andra: läs varför med docker compose -f deploy/prod-allinone/docker-compose.yml logs --tail=80.

Tips Videosamtal på den här servern behöver också medietjänstens UDP-port och ett TURN-relä: runbooken för en enda nod i förrådet beskriver de extra inställningarna.

Tillbaka till guiden

Produktivitet, made in Italy.

Ge hela sviten till ditt team – enkel, säker och helt din.