Installationsanleitung

Erste Anmeldung und Betrieb

Der erste Administrator, Aktualisierungen, Sicherungen, Coming soon und die Sicherheitsrichtlinie.

Der erste Administrator

Die Registrierung steht nur Personen mit Einladungscode offen, und die Codes werden in der Konsole erzeugt — die noch niemand öffnen kann. Der erste Code wird auf dem Rechner selbst erzeugt.

  1. Image: auf dem Server, im Stammverzeichnis des Repositorys, docker compose -f deploy/prod-allinone/docker-compose.yml exec -e MERYDION_DATA_ROOT=/var/lib/merydion/data merydion merydion-auth invite-code.
  2. Ordner: in PowerShell, im Ordner, $env:MERYDION_DATA_ROOT = (Resolve-Path .\data).Path; .\bin\merydion-auth.exe invite-code.
  3. Der Befehl gibt einen Code der Form XXXX-XXXX-XXXX aus; invite-code 5 gibt fünf aus.
  4. Klicken Sie im Portal auf Anmelden und dann auf Konto erstellen: Geben Sie den Code ein, registrieren Sie sich mit der in ADMINISTRATORS eingetragenen E-Mail-Adresse und bestätigen Sie sie mit dem Code aus der Bestätigungs-E-Mail.
  5. Melden Sie sich an: Diagnose am Fuß jeder Seite öffnet die Konsole, in der die weiteren Einladungscodes erzeugt werden.

Tipp Kommt die Bestätigungs-E-Mail nicht an, prüfen Sie das Passwort des Postfachs: Der Anmeldedienst meldet beim Start, wenn es fehlt.

Aktualisieren

Eine Aktualisierung ersetzt das Image und behält die Daten: Sie liegen im Volume des Containers, das zum Projekt gehört und nicht zum Image.

  1. Erstellen Sie auf dem Entwicklungsrechner mit dem aktualisierten Repository das neue Image: .\rebuild_container_release.ps1 -NoSeedData.
  2. Kopieren Sie es auf den Server, prüfen und laden Sie es wie beim ersten Mal: sha256sum -c merydion-allinone.tar.sha256 && docker load -i merydion-allinone.tar.
  3. Starten Sie mit demselben Befehl wie beim ersten Mal: docker compose --env-file deploy/prod-allinone/.env -f deploy/prod-allinone/docker-compose.yml up -d bemerkt das neue Image und erstellt den Container neu, mit einer Unterbrechung von wenigen Sekunden.
  4. Öffnen Sie die Konsole auf der Registerkarte Aktualisierung: Wo eine Zeile Aktualisierung verfügbar zeigt, klicken Sie auf Aktualisierung ausführen — bis dahin bleiben die Datenfunktionen dieses Dienstes ausgeschaltet.

Tipp Kontrollieren Sie vor jeder Aktualisierung in der Diagnose, ob die Kopien der Datenbanken in Ordnung sind (die Karte „Kopien der Datenbanken“), und kopieren Sie die Dateien: Die Aktualisierung der Datenbanken arbeitet auf einer Kopie und behält das Original, bis die Kopie geprüft ist, aber die Kopien sind Ihr eigener Weg zurück.

Kopien und Wiederherstellung

Jeder Dienst hält eine fortlaufende Kopie der Datenbanken, die er verwaltet — Konten, Dokumentindizes, E-Mail, Chats —, höchstens rund eine Sekunde im Rückstand, und kann sie auf jeden beliebigen Zeitpunkt der letzten sieben Tage wiederherstellen. Die Dateien selbst — Dokumente, Anhänge, Vorschauen — werden einmal geschrieben und ändern sich nie: Sie werden separat kopiert oder liegen in einem S3-Bucket.

  1. Lagern Sie die Kopien der Datenbanken vom Rechner aus: Registrieren Sie ein Ziel der Klasse backups in einem S3-Bucket oder auf einem anderen Datenträger und aktivieren Sie es.
  2. Image: Kopieren Sie im laufenden Betrieb die Dateien ohne die Datenbanken: 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 .' schreibt ein datiertes Archiv in den Ordner files.
  3. Ordner: Stoppen Sie ihn mit .\stop.ps1, kopieren Sie den Ordner data vollständig und starten Sie ihn dann wieder.
  4. Hat ein Administrator ein weiteres Ziel für die Dateien registriert, kopieren Sie dessen Ordner im selben Durchgang: Die Dateien, die nach seiner Aktivierung entstanden sind, liegen nur dort.
  5. Bewahren Sie die Kopien fern vom Rechner auf, den sie schützen.

Tipp Um eine Datenbank oder die ganze Installation auf einen Zeitpunkt zurückzusetzen, halten Sie die Installation an und führen Sie merydion-storage copies restore aus (das Verfahren „Kopien und Wiederherstellung“ im Runbook): Der Befehl schreibt die wiederhergestellten Datenbanken in einen neuen Ordner, der dann an die Stelle des alten tritt.

Die Website auf Coming soon setzen

Coming soon zeigt jedem Besucher nur eine Vorschauseite, während die Installation vorbereitet wird: Portal, Apps, Palatys und Konsole warten dahinter, auch für Administratoren.

  1. Melden Sie sich als Administrator an und öffnen Sie https://merydion.example.com/coming-soon.html?enabled=true: Die Seite bestätigt, und die Website ist auf Coming soon.
  2. Um die Website wieder einzuschalten, öffnen Sie https://merydion.example.com/coming-soon.html?enabled=false: Nach der Bestätigung bringt Sie die Seite zur Startseite.
  3. Sind Sie nicht angemeldet, fordert die Seite Sie zuerst zur Anmeldung auf; einem Konto, das kein Administrator ist, sagt sie es, und nichts ändert sich.
  4. Der Zustand ist die Datei site/coming-soon im Datenordner: Wird sie entfernt, ist die Website auch ohne die Seite wieder eingeschaltet.

Tipp Die Coming-soon-Seite gibt es auf Englisch und Italienisch; Besucher mit einer anderen Sprache erhalten die englische.

Die Besuchsstatistiken einschalten

Die Website kann ihre Besuche mit Google Analytics 4 zählen und fragt dabei zuerst jeden Besucher um seine Einwilligung: Solange ein Besucher nicht zustimmt, wird nichts von Google geladen. Die Statistiken bleiben ausgeschaltet, bis die Installation ihre Mess-ID angibt, und die Verwaltungskonsole hat sie nie.

  1. Erstellen Sie in Google Analytics eine Property und einen Web-Datenstream für die Adresse der Website, und kopieren Sie dessen Mess-ID (sie beginnt mit G-).
  2. Image: Fügen Sie in der Datei .env neben docker-compose.yml die Zeile MERYDION_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX hinzu und erstellen Sie den Container mit docker compose up -d neu. Ordner: Exportieren Sie dieselbe Variable in der Sitzung vor start.ps1.
  3. Öffnen Sie die Website in einem privaten Fenster: Unten links erscheint der Hinweis zu den Besuchsstatistiken, und unten auf jeder Seite erscheint „Cookie-Einstellungen“.
  4. Um die Statistiken auszuschalten, leeren Sie die Variable und erstellen Sie den Container neu: Der Hinweis verschwindet, und die Browser derer, die zugestimmt hatten, laden Google Analytics nicht mehr.

Tipp Die Datenschutzerklärung und die Cookie-Richtlinie beschreiben die Statistiken bereits, in jeder Sprache, für die Installation, die sie einschaltet. Stellen Sie in der Property die gewünschte Datenaufbewahrung ein — Google bewahrt die Daten eines Besuchs höchstens 14 Monate auf — und lassen Sie die Google-Signale ausgeschaltet: Die Website schaltet sie auch auf ihrer Seite aus.

Die Website für Suchmaschinen freigeben

Jede Installation weist Suchmaschinen an, sie nicht zu indexieren, bis sie die Indexierung einschaltet: Eine Kopie der Website, die nicht die offizielle ist — eine Testinstallation, die Installation einer Organisation —, macht ihr in den Ergebnissen nie Konkurrenz. Die Adressen, die die Seiten, die Vorschauen und die Sitemaps angeben, nennen die offizielle Website, https://merydion.eu, und die Kontoseiten, die Konsole und die Seite einer nicht vorhandenen Adresse gelangen nie in einen Index.

  1. Nur auf der Installation, die die offizielle Website ausliefert. Image: Fügen Sie in der Datei .env neben docker-compose.yml die Zeile MERYDION_SITE_INDEXING=1 hinzu und erstellen Sie den Container mit docker compose up -d neu. Ordner: Exportieren Sie dieselbe Variable in der Sitzung vor start.ps1.
  2. Prüfen Sie: curl -I https://merydion.eu/ zeigt den Header X-Robots-Tag: noindex nicht mehr, und https://merydion.eu/robots.txt verweist auf https://merydion.eu/sitemap.xml.
  3. Bestätigen Sie in der Google Search Console und in den Bing Webmaster Tools die Domain mit einem DNS-Eintrag und reichen Sie https://merydion.eu/sitemap.xml ein.
  4. Um die Website wieder aus den Suchmaschinen zu nehmen, leeren Sie die Variable und erstellen Sie den Container neu: Jede Antwort sagt wieder noindex, und die Suchmaschinen entfernen die Seiten bei ihrem nächsten Besuch.

Tipp Ein Portal, das für eine andere Adresse erzeugt wird, setzt beim Erzeugen MERYDION_SITE_ORIGIN (zum Beispiel https://www.example.com): Die kanonischen Adressen, die Sprachvarianten, die Vorschauen und die Sitemaps nennen dann diese Adresse. Die Seite einer nicht vorhandenen Adresse antwortet in der Sprache ihres Ordners, mit dem Status 404.

Die Content-Security-Policy des Portals

Die Seiten des Portals laufen unter einer strengen Content-Security-Policy, die das Gateway sendet: Eine Seite darf nur ihre eigenen Dateien nutzen, Anfragen an die eigene Herkunft stellen, Bilder auch aus data: und blob: laden und keinen Rahmen einer anderen Website zeigen. So kann ein eingeschleustes Stück Markup keinen Code ausführen. Die einzige Ausnahme sind die Besuchsstatistiken: Die Seiten, die Besuche zählen dürfen, lassen zusätzlich Googles gtag.js zu, nur auf dessen Pfad, und die Datenerfassung von Google Analytics, die erst geladen werden, nachdem ein Besucher zugestimmt hat.

  1. Ein angepasstes Portal mit Skripten oder Stilen, die in seinen Seiten stehen, funktioniert nicht: Skripte und Stile gehören in eigene Dateien.
  2. window.MERYDION_AUTH_BASE, window.MERYDION_API_BASE und window.MERYDION_DIAGNOSTICS_BASE können eine Familie von Anfragen nur unter einen anderen Pfad derselben Herkunft verschieben; eine Adresse auf einer anderen Herkunft wird ignoriert, mit einem Fehler in der Konsole des Browsers.
  3. Die Seiten der Konsole der Installation tragen die Richtlinie ohne die Ausnahme für die Statistiken und können zusätzlich nicht in einem Rahmen angezeigt werden.
  4. Die Richtlinie steht in apps/portal-csp.mjs und in den drei Caddyfiles, und ein Test hält sie gleich: Ändern Sie sie an allen vier Stellen zugleich.

Tipp Das Anmeldeformular des Identitätsdienstes und die Ablehnungsseite der Konsole kommen mit einer eigenen, noch strengeren Richtlinie.

Zurück zur Anleitung

Produktivität, made in Italy.

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