← Alle Anleitungen

Docker-Installation

Ideal für den Betrieb im internen Netz Ihrer Organisation. Ein Befehl, und der Assistent läuft als lokaler Webserver — erreichbar für alle Mitarbeitenden über den Browser.

⏱ ca. 10 Minuten 👤 IT-Admins

Was Sie brauchen

  • Docker Desktop (Windows/macOS) oder Docker Engine (Linux) — Installation
  • Zugang zur Kommandozeile (Terminal, PowerShell oder CMD)
  • Internetverbindung zum Herunterladen des Images (danach offline nutzbar)
1

Image herunterladen

Öffnen Sie ein Terminal und führen Sie folgenden Befehl aus:

docker pull ghcr.io/gsa/grundschutz-assistent:latest

Docker lädt das Image herunter. Das dauert je nach Internetverbindung ein bis zwei Minuten.

2

Container starten

docker run -d --name gsa -p 8080:80 ghcr.io/gsa/grundschutz-assistent:latest

Der Assistent läuft jetzt im Hintergrund. Öffnen Sie Ihren Browser und navigieren Sie zu:

http://localhost:8080
Isis Tipp: Die Daten werden im Browser der jeweiligen Nutzerin gespeichert — nicht im Container. Wenn Sie den Container stoppen und neu starten, gehen keine Daten verloren.
3

Im internen Netz bereitstellen

Damit andere Mitarbeitende den Assistenten nutzen können, starten Sie den Container mit der IP-Adresse Ihres Servers:

docker run -d --name gsa -p 0.0.0.0:8080:80 --restart unless-stopped ghcr.io/gsa/grundschutz-assistent:latest

Die Kolleginnen und Kollegen öffnen dann im Browser:

http://<server-ip>:8080

Das Flag --restart unless-stopped sorgt dafür, dass der Container nach einem Server-Neustart automatisch wieder startet.

4

Container verwalten

# Status prüfen docker ps # Container stoppen docker stop gsa # Container wieder starten docker start gsa # Auf neue Version aktualisieren docker pull ghcr.io/gsa/grundschutz-assistent:latest docker stop gsa && docker rm gsa docker run -d --name gsa -p 8080:80 --restart unless-stopped ghcr.io/gsa/grundschutz-assistent:latest

HTTPS einrichten (empfohlen)

Für den Betrieb im internen Netz empfehlen wir, einen Reverse-Proxy mit TLS-Zertifikat vorzuschalten. Wenn Sie bereits nginx, Apache oder Traefik im Einsatz haben, leiten Sie den Traffic auf Port 8080 des Containers weiter.

Eine ausführliche Anleitung dazu finden Sie in der technischen Dokumentation.