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
…
[2026-10-08T04:58:00.780Z] INFO No license scope found - running in demo mode with max 50 assignments.
[2026-10-08T04:58:00.781Z] INFO Ensuring CouchDB system databases exist at http://localhost:5984
[2026-10-08T04:58:00.894Z] INFO Created CouchDB document database live
[2026-10-08T04:58:00.933Z] INFO Created database lifecycle marker for live
[2026-10-08T04:58:00.979Z] INFO Generated shared session-signing secret for the configured document store.
[2026-10-08T04:58:01.168Z] INFO Initial admin user System Administrator (49eb7b1f-3ef5-4a6b-acda-091c0d1e2fb7) has a new registration token valid until 2026-10-09T04:58:01.148Z; retrieve it on the host, it is not logged
…
[2026-10-08T04:58:03.753Z] INFO live server listening on http://0.0.0.0: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. Das Token selbst steht aus Sicherheitsgründen nicht im Log; Sie erzeugen es sich lokal am Server mit live token (siehe Zugriff). 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.

Das Registrierungs-Token für den Administrator erzeugen Sie lokal am Server, mit derselben Datenbank-Verbindung wie beim Start:

$ live token
Admin token created
Token: 081d849d-feea-43ec-9c53-d852f191ecd7
Expires at: 2026-11-07T04:58:42.556Z
Account ID: 49eb7b1f-3ef5-4a6b-acda-091c0d1e2fb7
Account name: System Administrator
Multi use: false

Wenn Sie livectl verwenden, wählen Sie den lokalen Server mit livectl server http://localhost:8080 aus. Die Registrierung erfolgt mit dem Befehl livectl register <token>; damit ist livectl zugleich angemeldet.

Bei dem Beispiel von oben wäre das dann:

$ livectl register 081d849d-feea-43ec-9c53-d852f191ecd7
Als System Administrator angemeldet (verifiziert: true)
Konfiguration: /home/admin/.config/live/livectl.config.yaml

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
Admin token created
Token: 5e4780f9-ccbf-4d58-9a28-fe4265df788e
Expires at: 2026-11-07T05:12:30.118Z
Account ID: 49eb7b1f-3ef5-4a6b-acda-091c0d1e2fb7
Account name: System Administrator
Multi use: false

Das funktioniert ausschließlich lokal am Server und mit passendem Zugriff auf die Datenbank. Ohne weitere Angabe gilt das Token 30 Tage und nur einmal. Mit den Optionen --multi-use und --ttl-days können Sie ein mehrfach nutzbares bzw. anders befristetes Token erzeugen, mit --token den Wert selbst vorgeben.

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 --admin tokens list auf (die Verwaltung von Tokens verlangt den Admin-Modus):

$ livectl --admin tokens list
ID                                    Konto                 Gültig bis                Verwendet am              Mehrfach nutzbar
------------------------------------  --------------------  ------------------------  ------------------------  ----------------
081d849d-feea-43ec-9c53-d852f191ecd7  System Administrator  2026-11-07T04:58:42.556Z  2026-10-08T04:58:58.704Z  false
345155b0-9d40-42fe-854d-e97e8a9ae98d  System Administrator  2026-10-09T04:58:01.148Z                            false
5e4780f9-ccbf-4d58-9a28-fe4265df788e  System Administrator  2026-11-07T05:12:30.118Z  2026-10-08T05:13:02.410Z  false

Entfernen Sie nicht mehr benötigte Token mit livectl --admin tokens remove <ids...> (mehrere IDs durch Leerzeichen getrennt). Das Ergebnis meldet livectl als JSON, hier für die beiden alten Token gekürzt auf das erste:

$ livectl --admin tokens remove 08 34
{
  "action": "remove",
  "total": 2,
  "rows": [
    {
      "identifier": "081d849d-feea-43ec-9c53-d852f191ecd7",
      "resolvedId": "081d849d-feea-43ec-9c53-d852f191ecd7",
      "token": {
        "id": "081d849d-feea-43ec-9c53-d852f191ecd7",
        "action": "remove",
        "noop": false,
        "diff": {
          "archived": false,
          "removed": true,
          "purged": false,
          "restored": false
        },
        …
      }
    },
    …
  ]
}

Information:
livectl akzeptiert Abkürzungen bei IDs, solange diese eindeutig sind. Aufruf ohne Verb (livectl --admin tokens) entspricht livectl --admin 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.