Installationsguide

Första inloggning och drift

Den första administratören, uppgraderingar, säkerhetskopior, coming soon och säkerhetspolicyn.

Den första administratören

Registreringen är bara öppen för den som har en inbjudningskod, och koderna skapas i konsolen — som ingen ännu kan öppna. Den första koden skapas på själva datorn.

  1. Avbild: på servern i roten av förrådet, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Mapp: i PowerShell i mappen, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Kommandot skriver ut en kod i formen XXXX-XXXX-XXXX; invite-code 5 skriver ut fem.
  4. Klicka på Logga in i portalen och sedan på Skapa konto: ange koden, registrera dig med e-postadressen i ADMINISTRATORS och bekräfta den med koden från verifieringsmejlet.
  5. Logga in: Diagnostik längst ned på varje sida öppnar konsolen, där de övriga inbjudningskoderna skapas.

Tips Om verifieringsmejlet inte kommer, kontrollera brevlådans lösenord: inloggningstjänsten säger vid start när det saknas.

Uppgradera

En uppgradering byter avbilden och behåller data: de ligger i containerns volym, som hör till projektet och inte till avbilden.

  1. Bygg den nya avbilden på utvecklingsdatorn med det uppdaterade förrådet: .\rebuild_container_release.ps1 -NoSeedData.
  2. Kopiera den till servern, kontrollera den och läs in den som första gången: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Starta med samma kommando som första gången: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d märker den nya avbilden och skapar om containern, med ett avbrott på några sekunder.
  4. Öppna konsolen på fliken Uppgradering: där en rad visar Uppgradering tillgänglig klickar du på Kör uppgradering — tills dess förblir tjänstens datafunktioner avstängda.

Tips Kontrollera i diagnostiken före varje uppgradering att kopiorna av databaserna är i ordning (kortet ”Kopior av databaserna”) och kopiera filerna: uppgraderingen av databaserna arbetar på en kopia och behåller originalet tills kopian är verifierad, men kopiorna är din egen väg tillbaka.

Kopior och återställning

Varje tjänst håller en löpande kopia av de databaser den förvaltar — konton, dokumentindex, e-post, chattar — som ligger högst ungefär en sekund efter, och kan återställa dem till valfritt ögonblick under de senaste sju dagarna. Själva filerna — dokument, bilagor, förhandsvisningar — skrivs en gång och ändras aldrig: de kopieras separat eller ligger i en S3-bucket.

  1. Flytta kopiorna av databaserna bort från datorn: registrera ett mål av klassen backups på en S3-bucket eller på en annan disk och aktivera det.
  2. Avbild: kopiera filerna, utan databaserna, medan den körs: 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 .' skriver ett daterat arkiv i mappen files.
  3. Mapp: stoppa den med .\stop.ps1, kopiera hela mappen data och starta den sedan igen.
  4. Om en administratör har registrerat ett annat mål för filerna, kopiera dess mapp i samma omgång: filerna som skapats efter att det aktiverades finns bara där.
  5. Förvara kopiorna långt från datorn de skyddar.

Tips För att föra tillbaka en databas eller hela installationen till ett visst ögonblick stoppar du installationen och kör merydion-storage copies restore (proceduren ”Kopior och återställning” i runbooken): den skriver de återställda databaserna i en ny mapp, som sedan tar den gamlas plats.

Sätt webbplatsen i coming soon

Coming soon visar varje besökare bara en förhandsvisningssida medan installationen förbereds: portalen, apparna, Palatys och konsolen väntar bakom den, även för administratörer.

  1. Logga in som administratör och öppna https://merydion.example.com/coming-soon.html?enabled=true: sidan bekräftar och webbplatsen är i coming soon.
  2. För att slå på webbplatsen igen öppnar du https://merydion.example.com/coming-soon.html?enabled=false: efter bekräftelsen tar sidan dig till startsidan.
  3. Om du inte är inloggad ber sidan dig först att logga in; till ett konto som inte är administratör säger den det, och ingenting ändras.
  4. Tillståndet är filen site/coming-soon i datamappen: tas den bort är webbplatsen påslagen igen även utan sidan.

Tips Coming soon-sidan finns på engelska och italienska; en besökare med ett annat språk får den engelska.

Slå på besöksstatistiken

Webbplatsen kan räkna sina besök med Google Analytics 4 och ber först varje besökare om samtycke: tills en besökare accepterar laddas ingenting från Google. Statistiken förblir avstängd tills installationen anger sitt mätnings-id, och administrationskonsolen har den aldrig.

  1. Skapa i Google Analytics en egendom och ett webbdataflöde för webbplatsens adress, och kopiera dess mätnings-id (det börjar med G-).
  2. Avbild: i filen .env bredvid docker-compose.yml lägger du till MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX och skapar om containern med docker compose up -d. Mapp: exportera samma variabel i sessionen före start.ps1.
  3. Öppna webbplatsen i ett privat fönster: nere till vänster visas meddelandet om besöksstatistik, och längst ned på varje sida visas ”Cookieinställningar”.
  4. För att stänga av statistiken tömmer du variabeln och skapar om containern: meddelandet försvinner, och webbläsarna hos dem som hade accepterat slutar ladda Google Analytics.

Tips Integritetspolicyn och cookiepolicyn beskriver redan statistiken, på alla språk, för den installation som slår på den. Ställ in den datalagring du vill ha i egendomen — Google sparar uppgifterna från ett besök i högst 14 månader — och låt Google-signaler vara avstängda: webbplatsen stänger också av dem från sitt håll.

Öppna webbplatsen för sökmotorer

Varje installation ber sökmotorerna att inte indexera den förrän den slår på indexeringen: en kopia av webbplatsen som inte är den officiella — en testinstallation, en organisations installation — konkurrerar aldrig med den i resultaten. Adresserna som sidorna, förhandsvisningarna och webbplatskartorna anger pekar på den officiella webbplatsen, https://merydion.eu, och kontosidorna, konsolen och sidan för en adress som inte finns hamnar aldrig i ett index.

  1. Bara på den installation som levererar den officiella webbplatsen. Avbild: i filen .env bredvid docker-compose.yml lägger du till MERYDION_SITE_INDEXING=1 och skapar om containern med docker compose up -d. Mapp: exportera samma variabel i sessionen före start.ps1.
  2. Kontrollera: curl -I https://merydion.eu/ visar inte längre huvudet X-Robots-Tag: noindex, och https://merydion.eu/robots.txt pekar på https://merydion.eu/sitemap.xml.
  3. I Google Search Console och i Bing Webmaster Tools verifierar du domänen med en DNS-post och skickar in https://merydion.eu/sitemap.xml.
  4. För att ta bort webbplatsen från sökmotorerna igen tömmer du variabeln och skapar om containern: varje svar säger noindex igen, och sökmotorerna tar bort sidorna vid sitt nästa besök.

Tips En portal som genereras för en annan adress anger MERYDION_SITE_ORIGIN (till exempel https://www.example.com) när den genereras: de kanoniska adresserna, språkvarianterna, förhandsvisningarna och webbplatskartorna pekar då på den adressen. Sidan för en adress som inte finns svarar på språket i sin mapp, med status 404.

Portalens Content-Security-Policy

Portalens sidor körs under en strikt Content-Security-Policy som gatewayen skickar: en sida får bara använda sina egna filer, förfrågningar till sitt eget ursprung, bilder även från data: och blob:, och ingen ram från en annan webbplats. Det är det som hindrar en vilsen bit markup från att köra kod. Det enda undantaget är besöksstatistiken: de sidor som får räkna besök tillåter också Googles gtag.js, bara på dess sökväg, och insamlingen till Google Analytics, som laddas först när en besökare har accepterat.

  1. En anpassad portal med skript eller stilar skrivna i sidorna fungerar inte: skript och stilar hör hemma i egna filer.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE och window.MERYDION_DIAGNOSTICS_BASE kan bara flytta en familj av förfrågningar till en annan sökväg på samma ursprung; en adress på ett annat ursprung ignoreras, med ett fel i webbläsarens konsol.
  3. Sidorna i installationens konsol har policyn utan undantaget för statistiken och kan dessutom inte visas i en ram.
  4. Policyn finns i apps/portal-csp.mjs och i de tre Caddyfilerna, och ett test håller dem lika: ändra den på alla fyra ställena samtidigt.

Tips Identitetstjänstens inloggningsformulär och konsolens avvisningssida kommer med en egen, ännu striktare policy.

Tillbaka till guiden

Produktivitet, made in Italy.

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