Zum Inhalt springen

Installation

  • Linux mit systemd (Ubuntu 22.04, Debian 12 oder neuer), x86_64 oder aarch64
  • ab 2 CPU-Kernen, 4 GB Arbeitsspeicher, lokale SSD; Platz nach Datenmenge
  • eine Adresse (z. B. wws.firma.de) mit TLS über einen Reverse Proxy oder einen Cloudflare-Tunnel
  • ein S3-kompatibler Speicher für Anhänge, Druckdateien und Medien (z. B. Hetzner Object Storage, Cloudflare R2, Garage oder MinIO auf dem eigenen Server)
  • curl, tar, openssl (auf den genannten Systemen vorhanden)
Terminal-Fenster
curl -fsSL https://kassier.eu/install.sh | sudo bash

Das Skript fragt beim ersten Lauf:

Abfrage Umgebungsvariable Beispiel
Öffentliche Adresse WWS_URL https://wws.firma.de
E-Mail des ersten Administrators WWS_ADMIN_EMAIL [email protected]
S3-Endpunkt, Bucket, Region WWS_S3_ENDPOINT, WWS_S3_BUCKET, WWS_S3_REGION https://fsn1.your-objectstorage.com, wws, auto
S3-Zugang WWS_S3_ACCESS_KEY_ID, WWS_S3_SECRET_ACCESS_KEY

Ohne Rückfragen, etwa für Automatisierung: Variablen vorher setzen und sudo -E bash install.sh aufrufen. Weitere Variablen: WWS_VERSION (bestimmte Version), WWS_INSTANCE (Vorgabe prod), WWS_PORT (Vorgabe 8080), WWS_ARCHIVE (lokales Archiv für Server ohne Internet; SHA256SUMS muss daneben liegen).

Pfad Inhalt
/srv/wws/<instanz>/env Umgebung mit allen Einstellungen, nur für root und den Dienst lesbar
/srv/wws/<instanz>/data/ Datenbanken (eine Datei je Mandant), Sicherungskopien, Importe
/srv/wws/<instanz>/releases/<version>/ Programm, Webclient und Handbuch; die letzten fünf Versionen bleiben
/srv/wws/<instanz>/current Verweis auf die laufende Version
/etc/systemd/system/[email protected] Dienst wws@<instanz>

ERP_SECRET_KEY sichern: Der Schlüssel in der Umgebung verschlüsselt die Anmeldeschlüssel und gespeicherte Zugangsdaten. Ohne ihn sind die Daten nach einer Wiederherstellung nicht nutzbar. Die Datei env gehört in jede Sicherung.

Kassier lauscht nur auf 127.0.0.1:8080. Caddy besorgt das Zertifikat selbst:

wws.firma.de {
reverse_proxy 127.0.0.1:8080
}

Steht ein anderer Proxy davor, dessen Adresse in ERP_TRUSTED_PROXIES eintragen, damit Anmeldesperren den echten Absender treffen.

Ohne feste IP, Portfreigabe oder Zertifikat, etwa für einen Server im Büro hinter dem Router: Der Tunnel baut die Verbindung von innen zu Cloudflare auf, am Server ist kein Port offen.

  1. Die Domain wird bei Cloudflare verwaltet (Nameserver bei Cloudflare), im eigenen Konto der Firma.
  2. Im Cloudflare-Dashboard unter Zero Trust → Networks → Tunnels einen Tunnel anlegen und das Token kopieren.
  3. Installieren oder erneut ausführen:
    Terminal-Fenster
    curl -fsSL https://kassier.eu/install.sh | sudo WWS_TUNNEL_TOKEN=<token> bash
    Das Skript installiert cloudflared aus der Paketquelle von Cloudflare (Ubuntu, Debian) und richtet es als Dienst ein. Updates kommen danach mit den Systemupdates.
  4. Im Tunnel einen öffentlichen Hostnamen anlegen, z. B. wws.firma.de, Ziel http://127.0.0.1:8080.

Gut zu wissen:

  • Cloudflare beendet TLS und sieht den Datenverkehr. Für personenbezogene Daten braucht es den Vertrag zur Auftragsverarbeitung mit Cloudflare (im Dashboard abschließbar).
  • Eine Anfrage darf in der kostenlosen Stufe höchstens 100 MB groß sein und muss nach 100 Sekunden antworten.
  • Hinter dem Tunnel kommen alle Anfragen von 127.0.0.1. Kassier liest den echten Absender aus dem Kopf CF-Connecting-IP; dafür ist nichts einzustellen.
  • Optional schützt Cloudflare Access die Adresse zusätzlich, z. B. mit einem Code per E-Mail vor der Anmeldung. Shops und Apps, die Kassier direkt ansprechen, brauchen dann ein Service-Token.

Für „Passwort vergessen“, Einladungen und Hinweise bei neuen Geräten braucht Kassier einen Mailversand. Die ERP_SMTP_*-Werte in env eintragen und den Dienst neu starten: systemctl restart wws@prod.

Unter der Adresse mit dem ausgegebenen Passwort anmelden, das Passwort ändern und den Mandanten einrichten.