Setup

Systemanforderungen

Stellen Sie vor der Installation sicher, dass Ihr System die folgenden Mindestanforderungen erfüllt:

Betriebssystem: 64-Bit-Windows, Linux oder macOS
RAM: Mindestens 8 GB (16 GB empfohlen)
Speicherplatz: Mindestens 10 GB freier Speicherplatz
Java: JDK oder JRE Version 21

Überprüfen Sie Ihre Java-Installation, indem Sie Folgendes ausführen:

java -version

Installationsmethoden

Portable Distribution

Die portable Distribution ermöglicht es Ihnen, Flowset Control ohne zusätzliche Abhängigkeiten (außer Java) auszuführen. Sie wird als eigenständige Anwendungs-JAR ausgeliefert und läuft mit einer eingebetteten HSQLDB-Datenbank, die beim ersten Start automatisch erstellt wird — eine externe Datenbank ist nicht erforderlich. Ideal für schnelle Tests oder die lokale Entwicklung.

Beziehen Sie das neueste Flowset Control Distributionspaket von der offiziellen Downloadseite.

Download

Voraussetzungen:

Komponente	Anforderung
Java	JDK oder JRE 17 (Java 21 wird ebenfalls unterstützt)
Betriebssystem	Linux, macOS oder Windows
Port 8081	Muss frei sein (konfigurierbar, siehe unten)
RAM	Mindestens 512 MB für die JVM verfügbar

Komponente

Anforderung

Java

JDK oder JRE 17 (Java 21 wird ebenfalls unterstützt)

Betriebssystem

Linux, macOS oder Windows

Port 8081

Muss frei sein (konfigurierbar, siehe unten)

RAM

Mindestens 512 MB für die JVM verfügbar

Das Archiv hat die folgende Struktur:

flowset-control-community/
├── flowset-control-community-2026.0.1-rc.jar   # kompilierte Anwendungs-JAR
├── run.sh  / run.bat                           # Anwendung starten
├── stop.sh / stop.bat                          # Anwendung stoppen
├── data/                                       # HSQLDB-Daten (wird automatisch erstellt)
└── README.md

Ausführungsanweisungen:

Beziehen Sie das portable Archiv von der offiziellen Downloadseite.
Entpacken Sie das Archiv in ein Verzeichnis Ihrer Wahl. Behalten Sie die Ordnerstruktur bei — die run/stop-Skripte müssen sich neben der Anwendungs-JAR befinden.
Starten Sie die Anwendung:

Linux/macOS:
```
chmod +x run.sh
./run.sh
```
Windows:
```
run.bat
```
Beim Start überprüft das Skript Java, startet die Anwendung und öffnet automatisch den Browser, sobald sie bereit ist.
Greifen Sie auf die Anwendung zu unter: http://localhost:8081.

Standard-Anmeldedaten: admin/admin. Ändern Sie das Standardpasswort unmittelbar nach der ersten Anmeldung.

Anwendung stoppen:

Linux/macOS:

./stop.sh

Windows:

stop.bat

HTTP-Port ändern:

Wenn Port 8081 bereits belegt ist, geben Sie beim Start einen anderen Port an:

./run.sh --server.port=8090

run.bat --server.port=8090

Die eingebettete HSQLDB speichert ihre Dateien im Ordner data/ neben der JAR. Sie ist für Evaluierung und lokale Entwicklung gedacht. Verwenden Sie für den Produktivbetrieb die Konfiguration einer externen Datenbank mit Oracle oder PostgreSQL.

Docker Compose

Diese Methode ermöglicht einen schnellen Start von Flowset Control in Containern, ohne manuelle Datenbank- oder Umgebungskonfiguration.

Voraussetzungen:

Docker und Docker Compose
Überprüfen Sie die Installationen:
```
docker --version
docker compose version
```

Ausführungsanweisungen:

Erstellen Sie eine Datei docker-compose.yml mit folgendem Inhalt:

version: '3.8'

services:
  postgres:
    image: postgres:15
    environment:
      POSTGRES_DB: flowset-control
      POSTGRES_USER: root
      POSTGRES_PASSWORD: root
    ports:
      - "5432:5432"

  flowset-control:
    image: flowset/flowset-control-community:latest
    environment:
      MAIN_DATASOURCE_URL: jdbc:postgresql://postgres:5432/flowset-control
      MAIN_DATASOURCE_USERNAME: root
      MAIN_DATASOURCE_PASSWORD: root
      SERVER_PORT: 8081
    ports:
      - "8081:8081"
    depends_on:
      - postgres

Starten Sie die Container:
```
docker compose up -d
```
Greifen Sie auf die Anwendung zu unter: http://localhost:8081.
So stoppen Sie die Container:
```
docker compose down
```

Ausführliche Anweisungen finden Sie auf GitHub.

Build aus dem Quellcode

Erstellen und führen Sie die Anwendung aus dem Quellcode aus, für die Entwicklung oder benutzerdefinierte Bereitstellungen.

Voraussetzungen:

Git
Java 21 JDK
PostgreSQL-Datenbank

Ausführungsanweisungen:

Klonen Sie das Repository:

git clone https://github.com/flowset/flowset-control-community

Konfigurieren Sie die PostgreSQL-Datenbank.

Flowset Control speichert Daten, wie zum Beispiel BPM-Engine-Verbindungen, in einer Datenbank. Standardmäßig benötigt Flowset Control eine PostgreSQL-Datenbank mit den folgenden Parametern:
- Datenbankname: flowset-control
- Benutzername: root
- Passwort: root
Navigieren Sie in das Projektverzeichnis und führen Sie aus:
```
./gradlew bootRun
```
Greifen Sie auf die Anwendung zu unter: http://localhost:8081.

WildFly-Bundle

Ein eigenständiges Archiv, das den WildFly-Anwendungsserver bereits mit vorinstalliertem und vorkonfiguriertem Flowset Control enthält. Ein separater WildFly-Download oder eine manuelle Bereitstellung ist nicht erforderlich. Standardmäßig läuft die Anwendung mit einer eingebetteten HSQLDB-Datenbank, die beim ersten Start automatisch erstellt wird, sodass für den Einstieg keine externe Datenbank benötigt wird.

Voraussetzungen:

Komponente	Anforderung
Java	JDK oder JRE 17 (Java 21 wird ebenfalls unterstützt)
Betriebssystem	Linux, macOS oder Windows
Port 8080	Muss frei sein (konfigurierbar, siehe unten)
RAM	Mindestens 2 GB für die JVM verfügbar

Komponente

Anforderung

Java

JDK oder JRE 17 (Java 21 wird ebenfalls unterstützt)

Betriebssystem

Linux, macOS oder Windows

Port 8080

Muss frei sein (konfigurierbar, siehe unten)

RAM

Mindestens 2 GB für die JVM verfügbar

Das Archiv hat die folgende Struktur:

flowset-control-community-wildfly-2026.0.1/
├── server.tar.gz                         # WildFly + bereitgestellte App (beim ersten Start entpackt)
├── start.sh / start.bat                  # Server starten
├── stop.sh  / stop.bat                   # Server ordnungsgemäß stoppen
└── README.md

Beim ersten Start wird server.tar.gz automatisch in einen server/wildfly/-Ordner neben den Skripten entpackt (ein einmaliger Schritt von wenigen Sekunden):

flowset-control-community-wildfly-2026.0.1/
└── server/wildfly/                       # WildFly-Anwendungsserver
    ├── bin/standalone.conf               # für Flowset Control vorkonfiguriert
    └── standalone/deployments/
        └── flowset-control-community-2026.0.1.war   # bereits bereitgestellt

Der Server wird als inneres server.tar.gz ausgeliefert, sodass das äußere Archiv nur kurze Pfade enthält. Dadurch lässt es sich mit dem integrierten Entpacker unter Windows und macOS öffnen, ohne die 260-Zeichen-Pfadgrenze von Windows zu erreichen. Das Entpacken erfolgt mit tar (in Windows 10 1803+, Windows 11, macOS und Linux integriert), das keine solche Grenze hat.

Ausführungsanweisungen:

Beziehen Sie das WildFly-Bundle von der offiziellen Downloadseite.
Entpacken Sie das Archiv in ein Verzeichnis Ihrer Wahl. Behalten Sie die Ordnerstruktur bei — die start/stop-Skripte müssen sich neben server.tar.gz befinden. Unter Windows funktioniert der integrierte Explorer-Entpacker hier problemlos, da das Archiv nur kurze Pfade enthält.
Starten Sie den Server (beim ersten Start wird der mitgelieferte Server automatisch entpackt):

Linux/macOS:
```
chmod +x start.sh
./start.sh
```
Windows:
```
start.bat
```
Der Start dauert etwa 40–60 Sekunden. Ein erfolgreicher Start endet mit einer Zeile wie WildFly 40.0.0.Final started in 43443ms.
Greifen Sie auf die Anwendung zu unter: http://localhost:8080.

Standard-Anmeldedaten: admin/admin. Ändern Sie das Standardpasswort unmittelbar nach der ersten Anmeldung.

Server stoppen:

Linux/macOS:

./stop.sh

Windows:

stop.bat

HTTP-Port ändern:

Wenn Port 8080 bereits belegt ist, geben Sie beim Start einen anderen Port an:

./start.sh -Djboss.http.port=8090

start.bat -Djboss.http.port=8090

Zustandsprüfung (Health Check):

curl http://localhost:8080/actuator/health
# Erwartet: {"status":"UP"}

Protokolldateien:

server/wildfly/standalone/log/server.log

Aktualisierung auf eine neue Version:

Ersetzen Sie die WAR-Datei im Deployments-Ordner, während WildFly läuft — sie wird automatisch neu geladen:

cp flowset-control-community-2026.0.1.war \
   server/wildfly/standalone/deployments/

Die eingebettete HSQLDB ist für Evaluierung und kleine Installationen gedacht. Richten Sie für den Produktivbetrieb die Anwendung auf eine externe Datenbank aus, indem Sie server/wildfly/bin/standalone.conf bearbeiten — kommentieren Sie den Oracle- oder PostgreSQL-Block main.datasource. aus und setzen Sie URL, Benutzername und Passwort (oder geben Sie diese über die Umgebungsvariablen FLOWSET_DB_URL / FLOWSET_DB_USER / FLOWSET_DB_PASS an). Unterstützt: *Oracle 19c+ und PostgreSQL. Starten Sie den Server nach der Konfigurationsänderung neu.

Nach der Installation

Nach erfolgreicher Installation:

Öffnen Sie Ihren Webbrowser und navigieren Sie zu http://localhost:8081.
Verwenden Sie die Standard-Administrator-Anmeldedaten (admin/admin).
Konfigurieren Sie Ihre BPM-Engine-Verbindungen.