Docker-Installation (Unix)

Docker-Installation (Unix)#

Dieses Handbuch beschreibt, wie Allegra auf Unix-basierten Systemen mit Docker Compose und dem offiziellen vorgepackten Docker Bundle ausgeführt wird.

Diese Methode stellt ein sofort einsatzbereites Allegra-Docker-Image bereit (einschließlich Java 21) sowie einen separaten PostgreSQL-Datenbank-Container.

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#

Stellen Sie vor der Installation sicher, dass Folgendes vorhanden ist:

  • Unix-basiertes System (Docker OS-Unterstützung)

  • Docker Engine und Docker Compose sind installiert und laufen (Docker installieren)

  • Ausreichend Speicherplatz (mindestens 20 GB)

  • Verfügbarer Netzwerkport (Standard 8080 oder konfiguriert)

  • Benutzerkonto mit Berechtigung zur Ausführung von Docker-Befehlen (sudo oder Mitglied der docker-Gruppe)

Bemerkung

Alle Allegra-Daten – Konfiguration, Anhänge, Protokolle und die Datenbank – werden in dem persistenten Host-Ordner gespeichert, den Sie als ALLEGRA_HOME_DIR festlegen und der im Container unter /home/allegra eingebunden ist.

Installationsschritte#

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

  1. Erstellen Sie das Allegra-Home-Verzeichnis

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

    sudo mkdir -p /home/ubuntu/allegra-home
sudo chmod 750 /home/ubuntu/allegra-home
sudo chown -R 999:999 /home/ubuntu/allegra-home

    Bemerkung

    ls zeigt die Gruppe möglicherweise als systemd-journal statt 999 an (auf vielen Ubuntu-Hosts ist die GID 999 dieser Gruppe zugeordnet). Das ist rein kosmetisch — Allegra verwendet die numerische ID, behalten Sie daher 999:999 bei.

  2. Laden Sie das Allegra-Docker-Paket herunter

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

    wget https://alltena.com/downloads/allegra/latest-dist/allegra-docker.zip

  3. Entpacken Sie das Archiv

    unzip allegra-docker.zip
cd allegra-docker

    Das entpackte Archiv enthält folgende Dateien: - docker-compose.yml - env (Vorlage für Umgebungsvariablen) - application.properties (Spring-Boot-Konfiguration, in den Container eingebunden) - README.md

  4. Konfigurieren Sie die Umgebungsvariablen

    Öffnen Sie die Datei env in einem Texteditor und passen Sie die Einstellungen an Ihre Umgebung an. Insbesondere sollte ALLEGRA_HOME_DIR auf den absoluten Pfad Ihres persistenten Allegra-Home-Verzeichnisses (ALLEGRA_HOME) aus Schritt 1 gesetzt werden, und DB_PASSWORD sollte auf ein starkes Datenbank-Passwort gesetzt werden.

    Beispielkonfiguration:

    CONTEXT=demo
TZ=Europe/Berlin
ALLEGRA_HOME_DIR=/home/ubuntu/allegra-home  # Pfad zu Ihrem ALLEGRA_HOME-Verzeichnis
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.

    mv env .env

  6. Starten Sie Allegra

    Starten Sie Allegra im Hintergrund mit Docker Compose:

    sudo docker compose up -d

    Dieser Befehl führt Folgendes aus: - Lädt das in der mitgelieferten docker-compose.yml angegebene Allegra-Image - Bindet das Host-Verzeichnis /home/ubuntu/allegra-home als persistentes Speicherverzeichnis ein - Mappt den Host-Port HTTP_PORT auf denselben Port im Container - Startet Allegra automatisch (restart: always)

  7. Zugriff auf Allegra

    Öffnen Sie nach kurzer Startzeit einen Browser und rufen Sie auf:

    http://<host>:${HTTP_PORT}/${CONTEXT}

    wobei <host> localhost ist, wenn Sie direkt auf dem Server surfen, oder die IP-Adresse bzw. der Hostname des Servers, wenn Sie von einem anderen Rechner zugreifen, und ${CONTEXT} der in Ihrer env-Datei festgelegte Kontext ist (Standard demo).

    Mit den Standardeinstellungen ist Allegra unter http://localhost:8080/demo erreichbar (z. B. http://192.168.1.10:8080/demo von einem anderen Rechner).

    Standard-Anmeldedaten:

    • Benutzername: admin

    • Passwort: tissi

    Warnung

    Ändern Sie aus Sicherheitsgründen das Standard-Administratorpasswort unmittelbar nach der ersten Anmeldung. Verwenden Sie ein starkes Passwort und bewahren Sie es sicher auf.

Betrieb#

Zur Verwaltung des Containers:

docker compose ps        # Status 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:<version>  # 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 gelöscht, die in Ihrem ALLEGRA_HOME gespeichert sind.

docker compose down
docker rmi alltena/allegra:<version>
docker rmi postgres:18
sudo rm -rf /home/ubuntu/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).