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 einen sofort einsatzbereiten Docker-Image bereit (einschließlich Java 21 und einer PostgreSQL-Datenbank).

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 eingebettete Datenbank – werden im Container unter /allegra-home gespeichert. Binden Sie dieses Verzeichnis stets auf einen persistenten Host-Ordner ein, der in dieser Anleitung als ALLEGRA_HOME bezeichnet wird.

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 755 /home/ubuntu/allegra-home

  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-latest.zip
cd allegra-docker-latest

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

  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.

    Beispielkonfiguration:

    CONTEXT=demo
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:

    docker compose up -d

    Dieser Befehl führt Folgendes aus: - Lädt das neueste Allegra-Image (alltena/allegra:latest) - Bindet das Host-Verzeichnis /home/ubuntu/allegra-home als persistentes Speicherverzeichnis ein - Mappt den Host-Port HTTP_PORT auf Port 8080 im Container - Startet Allegra automatisch (restart: unless-stopped)

  7. Zugriff auf Allegra

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

    http://localhost:${HTTP_PORT}

    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: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 gelöscht, die in Ihrem ALLEGRA_HOME gespeichert sind.

docker compose down
docker rmi alltena/allegra:latest
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).