Installation
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“- 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)
Installieren
Abschnitt betitelt „Installieren“curl -fsSL https://kassier.eu/install.sh | sudo bashDas 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).
Was das Skript anlegt
Abschnitt betitelt „Was das Skript anlegt“| 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.
TLS mit Caddy
Abschnitt betitelt „TLS mit Caddy“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.
Cloudflare-Tunnel
Abschnitt betitelt „Cloudflare-Tunnel“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.
- Die Domain wird bei Cloudflare verwaltet (Nameserver bei Cloudflare), im eigenen Konto der Firma.
- Im Cloudflare-Dashboard unter Zero Trust → Networks → Tunnels einen Tunnel anlegen und das Token kopieren.
- Installieren oder erneut ausführen:
Das Skript installiert
Terminal-Fenster curl -fsSL https://kassier.eu/install.sh | sudo WWS_TUNNEL_TOKEN=<token> bashcloudflaredaus der Paketquelle von Cloudflare (Ubuntu, Debian) und richtet es als Dienst ein. Updates kommen danach mit den Systemupdates. - Im Tunnel einen öffentlichen Hostnamen anlegen, z. B.
wws.firma.de, Zielhttp://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 KopfCF-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.
Mailversand
Abschnitt betitelt „Mailversand“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.