ZeitenSchleife installieren
Version 1.0.7 vom 20. November 2026

Docker Compose
1. ZIP entpacken und ein Terminal im Ordner mit compose.yaml öffnen.
2. .env.docker.example nach .env kopieren. ZS_DB_PASSWORD setzen.
3. docker compose up -d --build

Portainer mit Docker Standalone
1. Auf dem Docker-Host im ZIP-Ordner das Image bauen:
   docker build -t zeitenschleife:hinweise .
2. Unter Stacks → Add stack → Upload die portainer.yaml hochladen.
3. ZS_DB_PASSWORD als Umgebungsvariable setzen und den Stack bereitstellen.

Beide Vorlagen starten MariaDB und legen beim ersten Start die Datenbanken an.
Öffnen Sie auf dem Docker-Host http://127.0.0.1:5173. Legen Sie einen
lokalen Administrator an und verbinden Sie die Kerndatenbank:

  Server: database
  Port: 3306
  Datenbank: zeitenschleife_core
  Benutzer: zeitenschleife
  Passwort: Ihr Wert ZS_DB_PASSWORD

Verbinden Sie unter Administration → Plugins je Plugin die eigene Datenbank.
Die Namen lauten zeitenschleife_asset (Bestand), zeitenschleife_calendar
(Kalender), zeitenschleife_plans (Pläne), zeitenschleife_workflow (Abläufe),
zeitenschleife_mailclient (E-Mail-Client) und nach Freischaltung
zeitenschleife_portal (Portal).
Speichern Sie jede Verbindung und legen Sie die Plugin-Tabellen an.

Direkt mit Node.js 24
Bereiten Sie auf einem erreichbaren MySQL- oder MariaDB-Server eine Datenbank
für den Kern und je eine für die verwendeten Plugins vor. Starten Sie im
entpackten Ordner:

  node --env-file=.env.node.example server.js

Öffnen Sie http://localhost:5173. Verwenden Sie die Verbindungsdaten Ihres
Datenbankservers. Die App lauscht direkt gestartet auf allen Netzwerkschnittstellen.
Führen Sie die Ersteinrichtung nur in einem geschützten Netz durch.

Privat kostenlos und weitere Freigaben
Bestand, Kalender, Pläne, Abläufe und der E-Mail-Client mit persönlichen
Postfächern stehen dem lokalen Administratorkonto in der kostenlosen
Privatbasis zur Verfügung. Für Zusatzfreigaben, weitere Konten oder Business
fragen Sie eine Lizenz für Ihre Installations-ID an. Ein VaultiFy-Lizenz-ZIP
lässt sich unter Administration → Lizenzen importieren.

Die Online-Demo erreichen Sie unter https://demo.sowada.dev/.
Die integrierte Hilfe enthält die Versionshinweise zu den Änderungen.

Kioskmodus
Öffnen Sie nach der Anmeldung /kiosk oder wählen Sie in der Übersicht unter
Einstellungen → Allgemein „Kioskmodus öffnen“.

Hinweise
Hinweise nutzt die vorhandene Kerndatenbank zeitenschleife_core. Beim Start oder beim ersten Verbinden ergänzt ZeitenSchleife die Tabellen für Regeln und ausgeblendete Hinweise. Behalten Sie für ein Update den bisherigen Compose-Projektnamen oder Portainer-Stack mit seinen bestehenden Volumes bei. Sichern Sie App- und Datenbankdaten vor dem Update.

Öffnen Sie mit einem Administratorkonto das Fenster „Hinweise“ und wählen
Sie „Hinweis anlegen“. Wählen Sie als Quelle „Eigene Nachricht“. Geben Sie
Titel, Text, Zielgruppe und Zeitplan ein und speichern Sie den aktiven
Hinweis. Beim Start erscheinen passende Hinweise als kompakte Blasen.
Unter „Ereignisse → Hinweise“ sehen Administratorkonten die aktuell gültigen
Hinweise für ihr Konto, einschließlich ausgeblendeter Vorkommen. Dort können
sie ausgeblendete Hinweise wieder anzeigen.

Bestehende Installation aktualisieren
Sichern Sie die App-Daten und Datenbanken vor dem Update. Behalten Sie den
Compose-Projektnamen oder Portainer-Stack sowie dessen Volumes bei. Mit Compose
bauen und starten Sie die App erneut mit docker compose up -d --build. Für
Portainer bauen Sie das App-Image auf dem Zielhost neu und stellen den Stack
mit dem neu erstellten lokalen Image bereit.

E-Mail-Client bei bestehenden Datenbank-Volumes ergänzen
Die Initialisierung der MariaDB-Datenbanken läuft bei leerem db_data-Volume.
Für ein vorhandenes Volume legen Sie zeitenschleife_mailclient als
Datenbankadministrator an und vergeben die Rechte für den App-Benutzer:

  CREATE DATABASE IF NOT EXISTS zeitenschleife_mailclient CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  GRANT ALL PRIVILEGES ON `zeitenschleife\_mailclient`.* TO 'zeitenschleife'@'%';

Richten Sie die Datenbank danach in den Plugin-Einstellungen des E-Mail-Clients
ein.

Outlook, Microsoft 365 und Gmail ab Version 1.0.6
Öffnen Sie die reguläre HTTPS-Adresse Ihrer Installation. Legen Sie unter
Datenquellen → Mail-Apps eine eigene Anbieter-App für Microsoft Graph oder
die Gmail-API an. Verwenden Sie beim Anbieter die dort angezeigte
Rückrufadresse. Richten Sie danach die Bereitstellung für Ihr Postfach ein
und melden Sie es beim Anbieter an. Die integrierte Hilfe unter
/help/admin.html#mail-oauth-anmeldung führt durch die Einrichtung.

Bestehende SMTP- und IMAP-Bereitstellungen mit OAuth benötigen eine
Umstellung. Melden Sie Outlook oder Gmail für die jeweilige Mail-API neu an
oder hinterlegen Sie unterstützte Zugangsdaten für IMAP und SMTP. Für SMTP
steht auch ein Relay zur Verfügung.

Sichern Sie das App-Datenverzeichnis zusammen mit der Datenbank. Bei der
Einrichtung im Browser speichert ZeitenSchleife den automatisch erzeugten
Schlüssel für Datenquellen im App-Datenverzeichnis. Falls Sie vorher einen
eigenen DATA_SOURCE_KEY gesetzt haben, verwenden Sie denselben Wert beim
Update als Umgebungsvariable in Compose, Portainer oder Node.js.
