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

--alias <domain>

Zweitdomain, die dauerhaft auf die Adresse umleitet, z. B. --alias osthessen.vogelschlagmelder.de. Mehrfach möglich

--allow-smtp-override

Die Gruppe darf unter Kommunikation einen eigenen Mailserver eintragen

ohne --enable

Die Gruppe wird angelegt, aber noch nicht freigeschaltet. Später mit vsm-mt tenant enable fulda

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 auf public_base_url umgeleitet. 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.