Betrieb mit den Binaries#

Die Binaries stehen hier zur Verfügung.

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

Beispiel:

$ live serve
INFO  ✅ [APP] Config loaded: /config/config.yaml
INFO  ✅ [APP] Server running internally on http://localhost:8080

Danach können Sie im Browser die URL http://localhost:8080 aufrufen und gelangen so zu der App. Ohne weitere Konfiguration startet der Server mit einer sqlite Datenbank, die im Verzeichnis data gespeichert wird.

Das Verzeichnis wird vom Server angelegt, sollte es nicht existieren. Auch die Datenbank wird angelegt, wenn sie nicht existiert, bzw. automatisch upgedatet, wenn eine ältere Version gefunden wird.

Während des initialen Anlegens der Datenbank wird auch ein Administrator-Konto und ein initiales Registrierungs-Token erzeugt. Dieses Token ist nur einmal gültig.

Initialisieren der Datenbank ohne Server-Start#

Alternativ können sie auch die Datenbank initialisieren, ohne direkt den Server zu starten:

$ live init
INFO  ✅ [APP] Config loaded: /config/config.yaml
INFO  ✅ [APP] Database /data/live.db is being used
INFO  ✅ [APP] DB connected with driver sqlite. Open Connections: 1/0, InUse: 0, Idle: 1
INFO  ✅ [APP] Database Info: sqlite 3.41.2
INFO  ✅ [APP] Database is not initialized, running migration
INFO  ✅ [APP] Updating Database
INFO  ✅ [APP] Running initial Database Seeding
INFO  ✅ [APP] Admin-Account wurde angelegt. ID: 0c40916e-4b20-4385-836f-ba8cc893e58d
INFO  ✅ [APP] Admin Registration Token: f3ddf073-c2d3-4379-bdad-d21950bc5ff4
INFO  ✅ [APP] Database initialized successfully.

Das legt die Datenbank an (falls noch nicht geschehen) und füllt einige Tabellen mit Standardwerten. In diesem Zuge wird auch ein Administrator-Konto und ein Registrierungs-Token erzeugt.

Falls die Datenbank bereits existiert, wird sie ggf. auf eine neue Version upgedatet.

Zugriff#

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

Wenn Sie livectl verwenden, können Sie den Server mit dem Befehl livectl localhost auswählen. 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] Database /data/live.db is being used
INFO  ✅ [APP] DB connected with driver sqlite. Open Connections: 1/0, InUse: 0, Idle: 1
INFO  ✅ [APP] Database Info: sqlite 3.41.2
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 und mit passenden Rechten auf der Datenbank.

Aufräumen#

wenn Sie sich nun mit dem neuen Token anmelden, können Sie ggf. veraltete Token leicht aufräumen:

$ livectl token
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            

$ livectl token delete  f3 5e
token f3ddf073-c2d3-4379-bdad-d21950bc5ff4 deleted
token 5e4780f9-ccbf-4d58-9a28-fe4265df788e deleted

Information:
livectl akzeptiert Abkürzungen bei IDs, solange diese Eindeutig sind.

TIPP:
Löschen Sie einfach alle Token, indem Sie Subshells verwenden:

livectl token delete $(livectl token -q)

das -q verhindert überflüssige Ausgaben und wirft nur die IDs aus.

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.