Betrieb mit den Binaries#

Die Binaries stehen hier zur Verfügung.

Der Server benötigt eine erreichbare CouchDB (Version 3). Geben Sie deren Verbindungs-URL über die Umgebungsvariable LIVE_DATABASE_URL an (oder per Konfigurationsdatei, siehe Konfiguration).

Starten Sie den Server mit dem Befehl ./live serve (Linux), bzw. live.exe serve (Windows).

Beispiel:

$ export LIVE_DATABASE_URL=http://live:live@localhost:5984/live
$ live serve
INFO  ✅ [APP] Config loaded: /config/config.yaml
INFO  ✅ [APP] Connected to CouchDB at http://localhost:5984/live
INFO  ✅ [APP] running in demo mode with max 50 assignments
INFO  ✅ [APP] Admin-Account wurde angelegt. ID: 0c40916e-4b20-4385-836f-ba8cc893e58d
INFO  ✅ [APP] Admin Registration Token: f3ddf073-c2d3-4379-bdad-d21950bc5ff4
INFO  ✅ [APP] Server running on http://localhost:8080

Danach können Sie im Browser die URL http://localhost:8080 aufrufen und gelangen so zu der App.

Ohne erreichbare CouchDB startet der Server nicht vollständig: Import, Sync und Anhänge werden mit einem Fehler (HTTP 503) abgelehnt. Eine Single-Node-CouchDB ist für kleine Installationen ausreichend.

Beim ersten Start auf einer leeren Datenbank legt der Server automatisch ein Administrator-Konto und ein einmaliges Registrierungs-Token an und gibt das Token im Log aus. Ohne Lizenz läuft der Server im Demo-Modus (max. 50 Aufträge).

Auf einer frischen Single-Node-CouchDB erscheint beim Start die Meldung Request to create N=3 DB but only 1 node(s). Das ist normales Start-Rauschen und kein Fehler.

Möchten Sie das initiale Admin-Token vorgeben (z. B. um in einer Pipeline den Onboarding-Prozess zu automatisieren), setzen Sie es über LIVE_SYSTEM_INITIAL_ADMIN_TOKEN. Andernfalls erzeugt der Server eine GUID.

Zugriff#

Der Zugriff auf den Server erfolgt von einem beliebigen Endgerät.

Wenn Sie livectl verwenden, können Sie den lokalen Server mit dem Befehl livectl local auswählen (setzt die Server-URL auf http://localhost:8080). Die Registrierung erfolgt mit dem Befehl livectl register <token>.

Bei dem Beispiel von oben wäre das dann:

$ livectl register f3ddf073-c2d3-4379-bdad-d21950bc5ff4
Registrierung erfolgreich für Konto admin auf Gerät 9xme

Die Anmeldung erfolgt mit dem Befehl

$ livectl login
Anmeldung erfolgreich für Konto admin auf Gerät 9xme

Problembehandlung#

Wenn Sie die Administrator - Registrierung verloren haben, können Sie sich lokal am Server ein neues Registrierungs-Token für den Administrator erzeugen lassen:

$ live token
INFO  ✅ [APP] Config loaded: /config/config.yaml
INFO  ✅ [APP] Connected to CouchDB at http://localhost:5984/live
Admin token created successfully:
Token: 5e4780f9-ccbf-4d58-9a28-fe4265df788e
Expires At: 2025-11-18T14:49:12Z
Account ID: 0c40916e-4b20-4385-836f-ba8cc893e58d
Account Name: admin
Multi-use: false

Das funktioniert ausschließlich lokal am Server und mit passendem Zugriff auf die Datenbank. Mit den Optionen --multi-use und --ttl-days können Sie ein mehrfach nutzbares bzw. länger gültiges Token erzeugen.

Aufräumen#

Wenn Sie sich nun mit dem neuen Token anmelden, können Sie ggf. veraltete Token leicht aufräumen. Die vorhandenen Token listen Sie mit livectl tokens list auf:

$ livectl tokens list
ID                                    Konto                 Läuft ab am           Verwendet am          Mehrfachnutzung  
f3ddf073-c2d3-4379-bdad-d21950bc5ff4  System Administrator  2025-10-20T14:43:40Z  2025-10-19T14:46:28Z  false            
5e4780f9-ccbf-4d58-9a28-fe4265df788e  System Administrator  2025-11-18T14:49:12Z  2025-10-19T14:51:51Z  false            

Entfernen Sie nicht mehr benötigte Token mit livectl tokens remove <ids...> (mehrere IDs durch Leerzeichen getrennt):

$ livectl tokens remove f3 5e
token f3ddf073-c2d3-4379-bdad-d21950bc5ff4 entfernt
token 5e4780f9-ccbf-4d58-9a28-fe4265df788e entfernt

Information:
livectl akzeptiert Abkürzungen bei IDs, solange diese eindeutig sind. Aufruf ohne Verb (livectl tokens) entspricht livectl tokens list. Zum endgültigen Entfernen archivierter Token dient livectl tokens purge <ids...>.

Konfiguration#

Bitte sehen Sie sich die Anleitung für die Konfiguration im folgenden Kapitel an.

Lizenzbedingungen#

Für die Nutzung der Software gelten die beschriebenen Lizenzbedingungen.