Installation

Bei einer frischen Installation ohne Benutzer öffnet die App bei jedem Aufruf automatisch die Seite Ersteinrichtung (/setup) — auch die Login-Seite ist bis dahin nicht erreichbar.

Firmenname & Administrator-Account

• Firmenname — wird als Standard-Marke für eure Belege hinterlegt.
• Name, E-Mail, Passwort — der erste Administrator-Account.

Das Passwort muss mindestens 12 Zeichen lang sein und wird zusätzlich gegen bekannte Datenlecks geprüft.

App-URL

Die Basis-Adresse eurer Installation, z. B. https://donkeyworks.example.de. Bestimmt die Domain in Bestätigungslinks, etwa in Login-Mails.

Funktioniert auch mit einer lokalen Adresse oder IP, z. B. http://192.168.178.2:8080.

E-Mail-Versand

Tragt die SMTP-Zugangsdaten eures Mail-Providers ein: Host, Port, Verschlüsselung, Benutzername, Passwort, Absender-Adresse, Absender-Name.

Über den Button Mail-Server verifizieren schickt ihr euch einen sechsstelligen Bestätigungscode an die beim Administrator-Account eingetragene E-Mail-Adresse. Tippt den Code aus der E-Mail ein — er wird automatisch geprüft.

Cloudflare Turnstile

Ein Bot-Schutz von Cloudflare, Alternative zu reCAPTCHA. Schützt bei uns das Login-Formular vor automatisierten Anfragen.

Site Key und Secret Key aus eurem Cloudflare-Turnstile-Widget. Sobald beide Felder ausgefüllt sind, erscheint das Widget zum Lösen.

Kostenloser Account und Widget-Erstellung: dash.cloudflare.com/sign-up, Bereich "Turnstile".

MaxMind GeoIP (optional)

Ein Dienst, der zu einer IP-Adresse den ungefähren Standort ermittelt. Wird bei uns für die Standort-Warnung beim Login genutzt.

Account ID und License Key für die Standort-Warnung bei der Login-Bestätigung.

Kostenloser Account: maxmind.com/en/geolite2/signup.

Abschluss

Der Button Einrichtung abschließen wird aktiv, sobald alle Pflichtfelder ausgefüllt, der Mail-Server-Code bestätigt und die Turnstile-Prüfung gelöst ist. Nach dem Absenden seid ihr eingeloggt und landet auf dem Dashboard.

Danach

Die Ersteinrichtung lässt sich nur einmal durchlaufen. Ist sie abgeschlossen, leitet /setup stattdessen auf die normale Login-Seite um, über die ihr euch fortan mit dem angelegten Administrator-Account anmeldet.