Gruppen verwalten¶
Alle Befehle auf dieser Seite verwenden den Kurzbefehl vsm-mt aus der
Einrichtung.
Übersicht¶
vsm-mt tenant list
Name aktiv Adresse Zweitdomains Daten
berlin ja https://berlin.vogelschlagmelder.de - ok
ilmkreis ja https://ilmkreis.vogelschlagmelder.de arnstadt.vogelschlagmelder.de, … ok
koeln nein https://koeln.vogelschlagmelder.de - ok
Neue Gruppe aufnehmen¶
Beispiel: Die Gruppe in Fulda bekommt https://fulda.vogelschlagmelder.de.
1. DNS-Eintrag anlegen. fulda.vogelschlagmelder.de muss auf die
Adresse des Servers zeigen (A-Record oder CNAME), sonst kann kein
Zertifikat ausgestellt werden. Prüfen mit:
dig +short fulda.vogelschlagmelder.de
2. Gruppe anlegen.
vsm-mt tenant create fulda --url https://fulda.vogelschlagmelder.de --enable
Mandant fulda angelegt (aktiv).
Adresse: https://fulda.vogelschlagmelder.de
Datenordner: /data/volumes/fulda/data
Zugangsdaten (werden nur jetzt angezeigt, stehen in secrets/fulda.env):
Admin: admin / 6bW…
Meldezentrale: meldezentrale / Qh3…
Traefik-Konfiguration aktualisiert: /data/multitenant/traefik/vsm.yml
Das ist alles. Innerhalb von zehn Sekunden ist die Gruppe erreichbar, ohne
dass etwas neu gestartet werden muss. Die Zugangsdaten werden zufällig
erzeugt, ebenso die Schlüssel CSRF_SECRET und SETTINGS_SECRET.
3. Prüfen.
vsm-mt tenant check fulda
Anschließend https://fulda.vogelschlagmelder.de im Browser öffnen. Beim
allerersten Aufruf kann das Zertifikat ein paar Sekunden brauchen.
4. Zugangsdaten weitergeben. Die Gruppe meldet sich an und macht mit der Ersteinrichtung weiter. Sie sollte im Adminbereich unter Accounts persönliche Zugänge anlegen.
Weitere Möglichkeiten beim Anlegen:
Option |
Bedeutung |
|---|---|
|
Zweitdomain, die dauerhaft auf die Adresse umleitet, z. B. |
|
Die Gruppe darf unter Kommunikation einen eigenen Mailserver eintragen |
ohne |
Die Gruppe wird angelegt, aber noch nicht freigeschaltet. Später mit |
Zugangsdaten nachsehen und ändern¶
Die Zugangsdaten einer Gruppe stehen in multitenant/secrets/<name>.env:
sudo nano /srv/docker/multitenant/secrets/fulda.env
ADMIN_USER=admin
ADMIN_PASSWORD=…
MELDEZENTRALE_USER=meldezentrale
MELDEZENTRALE_PASSWORD=…
CSRF_SECRET=…
SETTINGS_SECRET=…
Nach dem Speichern übernimmt der Container die Änderung innerhalb von zehn
Sekunden. Ist ein Passwort zu kurz (unter 8 Zeichen) oder ein bekannter
Standardwert, wird die Gruppe nicht geladen und ist nicht erreichbar.
vsm-mt tenant check fulda nennt den Grund.
SETTINGS_SECRET nicht ändern
Mit SETTINGS_SECRET sind ein im Adminbereich gespeichertes SMTP-Passwort
und der Matrix-Token verschlüsselt. Wird der Wert geändert, müssen beide
neu eingetragen werden – genau wie bei einer einzelnen Installation.
Eigene Mailserver-Daten für eine einzelne Gruppe können ebenfalls hier
stehen (SMTP_HOST, SMTP_USER, SMTP_PASSWORD …). Sie haben dann
Vorrang vor den Werten aus hoster.env.
Adresse und Zweitdomains¶
Die Einstellungen einer Gruppe stehen in multitenant/tenants/<name>.toml:
enabled = true
public_base_url = "https://weimar-apolda.vogelschlagmelder.de"
data_dir = "../volumes/weimar-apolda/data"
aliases = ["weimar.vogelschlagmelder.de", "apolda.vogelschlagmelder.de"]
allowed_hosts = []
allow_smtp_override = true
widget_allowed_domains = ""
aliases– Zweitdomains. Wer sie aufruft, wird dauerhaft aufpublic_base_urlumgeleitet. Für jede Zweitdomain ist ebenfalls ein DNS-Eintrag nötig.allowed_hosts– weitere Domains, unter denen die Gruppe direkt (ohne Umleitung) erreichbar sein soll. Selten nötig.widget_allowed_domains– Vorgabe für die Webseiten, die das Meldeformular einbetten dürfen; die Gruppe kann sie unter Widgets selbst ändern.
Nach einer Änderung an Adresse oder Zweitdomains die Traefik-Konfiguration neu schreiben:
vsm-mt traefik-config
Gruppe stilllegen¶
vsm-mt tenant disable fulda
Die Gruppe ist danach nicht mehr erreichbar. Ihre Daten bleiben erhalten;
mit vsm-mt tenant enable fulda ist sie wieder da.
Soll eine Gruppe endgültig entfernt werden: zuerst sichern (siehe
Betrieb), die Sicherung der Gruppe
übergeben, dann die Dateien multitenant/tenants/fulda.toml,
multitenant/secrets/fulda.env und den Ordner volumes/fulda löschen.
Eine Gruppe zieht auf einen eigenen Server um¶
Der Datenordner volumes/<name>/data ist genau so aufgebaut wie der
Ordner data einer einzelnen Installation. Für einen Umzug:
vsm-mt tenant disable fulda
vsm-mt backup fulda --ziel /data/multitenant/backups/umzug
vsm-mt tenant export fulda --ziel /data/multitenant/export
Die Sicherung enthält Datenbank und Fotos. export/fulda.env enthält
Zugangsdaten und Schlüssel mit dem Präfix FULDA_, wie sie in einer
gemeinsamen .env stehen; für eine eigene .env das Präfix weglassen.
SETTINGS_SECRET unbedingt übernehmen. Auf dem neuen Server wird nach der
Installationsanleitung installiert und vor dem ersten
Start der Ordner data aus der Sicherung eingespielt.