Zum Inhalt springen

ZeitenSchleife mit Docker oder Portainer installieren

Beide Vorlagen starten zwei Container. ZeitenSchleife läuft im App-Container, MariaDB speichert die Daten. Bei einer neuen Installation legt MariaDB die Kern- und Plugin-Datenbanken an.

ZeitenSchleife als ZIP laden

Version 1.0.7 ·

Mit Docker Compose starten

Sie brauchen Docker mit Compose v2 und einen freien Port für die App. Beim ersten Start müssen die offiziellen Images für Node.js 24 und MariaDB 11.4 verfügbar sein. Docker Compose installieren

  1. ZIP entpacken und den Ordner mit compose.yaml im Terminal öffnen. Das ZIP enthält auch den Dockerfile und die gebaute WebApp. Compose-YAML einzeln herunterladen
  2. .env.docker.example als .env speichern und bei ZS_DB_PASSWORD ein eigenes Datenbankpasswort eintragen.
  3. App und Datenbank starten.
    docker compose up -d --build

Am Docker-Rechner http://127.0.0.1:5173 öffnen und im Browser fertig einrichten.

Mit Portainer starten

Sie brauchen Portainer mit einer Docker-Standalone-Umgebung. Der Stack verwendet das App-Image vom selben Docker-Host und startet MariaDB automatisch.

  1. Im entpackten ZIP-Ordner auf dem Docker-Host das App-Image bauen.
    docker build -t zeitenschleife:hinweise .
  2. In Portainer Stacks → Add stack → Upload wählen und die Portainer-YAML auswählen, die auch im ZIP liegt. Portainer-YAML herunterladen
  3. Als Umgebungsvariable ZS_DB_PASSWORD mit einem eigenen Datenbankpasswort hinzufügen und den Stack bereitstellen.

Am Docker-Rechner http://127.0.0.1:5173 öffnen und im Browser fertig einrichten. Falls Portainer auf einem anderen Rechner läuft, können Sie zur lokalen Einrichtung einen SSH-Tunnel zum Docker-Host verwenden.

App-Image auf einen anderen Docker-Host übertragen

Exportieren Sie das Image dort, wo Sie es gebaut haben. Laden Sie es dann auf dem Docker-Host, den Portainer verwaltet. Die beiden Rechner müssen dieselbe Containerarchitektur verwenden.

docker image save -o zeitenschleife-image.tar zeitenschleife:hinweise
docker image load -i zeitenschleife-image.tar

Im Browser fertig einrichten

  1. Ein lokales Administratorkonto mit eigenen Zugangsdaten anlegen.
  2. Die Kerndatenbank verbinden. Bei Docker und Portainer verwenden Sie Server database, Port 3306, Datenbank zeitenschleife_core, Benutzer zeitenschleife und Ihr Passwort aus ZS_DB_PASSWORD.
  3. Unter Administration → Plugins dieselben Verbindungsdaten mit dem jeweiligen Datenbanknamen eintragen, speichern und die Tabellen anlegen.
Bestand
zeitenschleife_asset
Kalender
zeitenschleife_calendar
Pläne
zeitenschleife_plans
Abläufe
zeitenschleife_workflow
E-Mail-Client
zeitenschleife_mailclient
Portal nach Freischaltung
zeitenschleife_portal

Die App-Daten und die Datenbank bleiben in den Volumes app_data und db_data. Sichern Sie beide zusammen.

Eine bestehende Installation aktualisieren

Sichern Sie zuerst das App-Datenverzeichnis und MariaDB. Behalten Sie beim Wechsel auf das neue ZIP Ihre .env, den Namen des Compose-Projekts oder Portainer-Stacks und die bestehenden Volumes bei. Bauen Sie das App-Image mit den aktualisierten Dateien und starten Sie den Stack nach der jeweiligen Anleitung.

Falls bereits ein DATA_SOURCE_KEY gesetzt ist, übernehmen Sie ihn beim Update. Prüfen Sie anschließend bisher per OAuth verbundene Postfächer.

MariaDB führt die Erstinitialisierung nur bei einem neuen Datenverzeichnis aus. Wenn die Datenbank für den E-Mail-Client noch fehlt, legen Sie sie über eine Verbindung mit Datenbank-Administrationsrechten an. Führen Sie für den Datenbanknutzer aus der mitgelieferten Docker-Vorlage diese SQL-Anweisungen aus.

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

Wenn Sie eine eigene MariaDB-Installation oder einen anderen Datenbanknutzer verwenden, passen Sie die Berechtigung daran an. Unter „Administration → Plugins“ tragen Sie die Verbindung für den E-Mail-Client ein und legen dort seine Tabellen an.

Den E-Mail-Client verbinden

Für Outlook und Microsoft 365 verwenden Sie Microsoft Graph, für Gmail die Gmail-API. Öffnen Sie Ihre Instanz über ihre reguläre HTTPS-Adresse und kopieren Sie unter „Datenquellen → Mail-Apps“ die Weiterleitungs-URI. Hinterlegen Sie sie in Ihrer App-Registrierung beim Anbieter. Tragen Sie die Zugangsdaten der Mail-App in ZeitenSchleife ein. Anschließend wählen Sie die App in einer neuen Mail-Bereitstellung und melden das Postfach einmal beim Anbieter an.

IMAP und SMTP verwenden Benutzername und Passwort. SMTP unterstützt auch Relay. Bei bestehenden SMTP- oder IMAP-Verbindungen mit OAuth stellen Sie die Anmeldung auf unterstützte Zugangsdaten um. Für Outlook und Gmail können Sie den E-Mail-Client über die jeweilige Mail-API neu verbinden. E-Mail-Eingangsregeln für Abläufe, Pläne und Kalender nutzen weiterhin eine IMAP-Quelle.

Die mitgelieferte Anwendungshilfe beschreibt die App-Registrierung, Berechtigungen und Umstellung unter „Administration → Outlook und Gmail im E-Mail-Client einrichten“.

Hinweise nach der Installation einrichten

Hinweise verwenden die Kerndatenbank von ZeitenSchleife. Beim Start mit verbundener Datenbank legt die App die benötigten Tabellen an.

Öffnen Sie mit einem Administratorkonto Hinweise → Hinweis anlegen. Für eine eigene Mitteilung wählen Sie „Eigene Nachricht“ und geben Titel, Text und Zielgruppe ein. Speichern Sie den aktiven Hinweis und prüfen Sie die Startanzeige mit einem Konto aus der Zielgruppe. Unter „Ereignisse → Hinweise“ können Administratoren aktuell gültige Hinweise für ihr eigenes Konto einsehen und wieder einblenden. Funktionen der Hinweise ansehen

Privat nutzen oder online ausprobieren

Der Download enthält die kostenlose Privatbasis für das lokale Administratorkonto. Sie umfasst Bestand, Kalender, Pläne, Abläufe und den E-Mail-Client für persönliche Postfächer. Teampostfächer gehören zu Business oder lassen sich für Privat separat freischalten. Individuelles Projekt besprechen

Über das Demo-Konto können Sie ZeitenSchleife direkt im Browser testen. Online-Demo und Zugangsdaten

ZIP direkt mit Node.js starten

Sie brauchen Node.js 24 und einen erreichbaren MySQL- oder MariaDB-Server. Legen Sie eine Kerndatenbank und je verwendetem Plugin eine eigene Datenbank an. Node.js herunterladen

ZIP entpacken, ein Terminal im App-Ordner öffnen und den Server starten.

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

Öffnen Sie auf demselben Rechner http://localhost:5173. Verwenden Sie bei der Einrichtung im Browser die Daten Ihres Datenbankservers. Führen Sie die Ersteinrichtung in einem geschützten Netz durch.