Docker-Installation (Windows)

Docker-Installation (Windows)#

Warnung

Experimentelles Feature — Der Betrieb von Allegra unter Windows mit Docker ist experimentell. Es kann zu Testzwecken funktionieren, ist aber nicht Teil unserer regulären Tests und kann je nach Docker- oder WSL-Konfiguration variieren. Für produktive Einsätze wird ein Unix-basiertes System empfohlen.

Dieses Handbuch beschreibt, wie Allegra unter Windows 11 (Pro, Enterprise oder Education) mit Docker Desktop und dem offiziellen und dem offiziellen vorgepackten Docker Bundle ausgeführt wird.

Diese Installationsmethode stellt einen sofort einsatzbereiten Allegra-Server bereit (einschließlich Java 21 und einer eingebetteten PostgreSQL-Datenbank) innerhalb eines isolierten Docker-Containers.

Achtung

Diese Anleitung dient nicht dazu, Ihren Server für den öffentlichen Internetzugriff abzusichern. Für diesen Zweck sind zusätzliche individuelle Sicherheitsmaßnahmen erforderlich.

Vorbereitung#

Bevor Sie beginnen, stellen Sie Folgendes sicher:

  • Unterstützte Windows-Edition: Windows 11 (Pro, Enterprise oder Education) mit aktiviertem WSL-2-Backend (WSL 2 aktivieren)

  • Docker Desktop für Windows ist installiert und läuft (Docker Desktop herunterladen)

  • Mindestens 20 GB freier Speicherplatz

  • Ausreichender Arbeitsspeicher (mindestens 4 GB RAM für Docker verfügbar)

  • Administratorrechte

  • Freier Netzwerkport (Standard 8080 oder wie konfiguriert)

Bemerkung

Windows Server wird für diese Installationsmethode nicht unterstützt. Allegra benötigt Docker Desktop mit WSL 2 (Linux-Container), was nur unter Windows 10/11 Pro, Enterprise oder Education verfügbar ist.

Bemerkung

Stellen Sie sicher, dass das Laufwerk, auf dem sich die Allegra-Daten befinden (z. B. C: oder D:), mit Docker Desktop geteilt ist. Überprüfen Sie dies in Docker Desktop unter Settings → Resources → File Sharing.

Installationsschritte#

Führen Sie die folgenden Schritte aus, um Allegra mit Docker unter Windows zu installieren und zu starten.

  1. Erstellen Sie das Allegra-Home-Verzeichnis

    Erstellen Sie ein persistentes Verzeichnis, in dem Allegra seine Daten speichert. Dieses Verzeichnis wird in dieser Anleitung als ALLEGRA_HOME bezeichnet.

    Beispiel (PowerShell):

    mkdir C:\allegra-home

  2. Laden Sie das Allegra-Docker-Paket herunter

    Laden Sie das neueste Allegra-Docker-Bundle von der Allegra-Downloadseite herunter.

    Sie können dafür Ihren Browser oder PowerShell verwenden:

    Invoke-WebRequest -Uri https://alltena.com/downloads/allegra/latest-dist/allegra-docker.zip -OutFile allegra-docker-latest.zip

  3. Entpacken Sie das Archiv

    Entpacken Sie die ZIP-Datei an einen geeigneten Ort, z. B. C:\allegra-docker.

    Expand-Archive allegra-docker-latest.zip -DestinationPath C:\allegra-docker
cd C:\allegra-docker

    Das entpackte Archiv enthält die folgenden Dateien: - docker-compose.yml - env (Vorlage für Umgebungsvariablen)

  4. Konfigurieren Sie die Umgebungsvariablen

    Öffnen Sie die Datei env in einem Texteditor (z. B. Notepad) und passen Sie die Einstellungen an Ihre Umgebung an.

    Achten Sie darauf, dass ALLEGRA_HOME_DIR auf den absoluten Windows-Pfad Ihres persistenten Datenverzeichnisses zeigt (verwenden Sie Schrägstriche oder doppelte Backslashes).

    Beispielkonfiguration:

    CONTEXT=demo
ALLEGRA_HOME_DIR=C:/allegra-home  # Unter Windows Schrägstriche verwenden
HTTP_PORT=8080
JAVA_OPTS=-Djava.awt.headless=true -Xmx2048m -Xms1024m
DB_USER=allegra
DB_PASSWORD=tissi189

  5. Benenne die Datei in `.env` um

    Docker Compose liest Umgebungsvariablen automatisch aus einer Datei namens .env.

    Rename-Item env .env

  6. Starten Sie Allegra

    Starten Sie Allegra im Hintergrundmodus mit Docker Compose:

    docker compose up -d

    Dadurch wird: - Das neueste Allegra-Image (alltena/allegra:latest) heruntergeladen - Das Host-Verzeichnis C:\allegra-home als persistenter Speicher eingebunden - Der Host-Port HTTP_PORT auf Port 8080 im Container gemappt - Allegra automatisch gestartet (restart: unless-stopped)

  7. Zugriff auf Allegra

    Nach kurzer Startzeit öffnen Sie Ihren Browser und rufen auf:

    http://localhost:HTTP_PORT

    Standardmäßig: http://localhost:8080

    Standard-Anmeldedaten:

    • Benutzername: admin

    • Passwort: tissi

Betrieb#

Verwalten Sie Allegra über PowerShell oder die Eingabeaufforderung:

docker compose ps        # Containerstatus prüfen
docker compose logs -f   # Live-Logs anzeigen
docker compose stop      # Allegra stoppen
docker compose start     # Wieder starten
docker compose down      # Container stoppen und entfernen

Allegra aktualisieren#

Um Allegra auf eine neuere Version zu aktualisieren, öffnen Sie die Datei docker-compose.yml und passen Sie den Image-Tag an, zum Beispiel:

image: alltena/allegra:9.0.0  # Die aktuelle Version finden Sie in unseren Release Notes

Anschließend laden Sie das neue Image herunter und starten den Container neu:

docker compose pull
docker compose up -d

Deinstallation#

Zum Entfernen von Allegra und allen Daten:

Warnung

Dadurch werden alle Allegra-Daten, die in Ihrem ALLEGRA_HOME gespeichert sind, dauerhaft gelöscht.

docker compose down
docker rmi alltena/allegra:latest
Remove-Item -Recurse -Force C:\allegra-home

Nach erfolgreicher Installation sollten Sie Ihre Instanz absichern, indem Sie das Administratorpasswort ändern und HTTPS über einen Reverse Proxy konfigurieren (siehe Nginx-Proxy-Beispiel oder Apache-Proxy-Beispiel).