imported>TechCorner-Redaktion: Neuer Artikel: Image-Wahl, Compose mit PostgreSQL, GF_-Variablen und __FILE, Reverse Proxy, Plugins, Updates

2026-10-17T00:00:00Z

Neuer Artikel: Image-Wahl, Compose mit PostgreSQL, GF_-Variablen und __FILE, Reverse Proxy, Plugins, Updates

Neue Seite

{{Steckbrief
| gilt_fuer = Grafana 13.2 als Docker-Container (grafana/grafana-enterprise bzw. grafana/grafana) mit PostgreSQL 18 auf Linux; Alternative Paketinstallation unter Debian 13
| bereich = Server-Software
| dauer = ca. 45 Minuten
| rechte = Root bzw. Mitglied der Gruppe docker
| stand = Oktober 2026
}}
'''Grafana mit Docker Compose installieren''' ist der schnellste Weg zu einer sauber getrennten, leicht aktualisierbaren Grafana-Instanz: ein Container für Grafana, eine PostgreSQL-Datenbank für Dashboards, Benutzer und Alarmregeln, die Konfiguration komplett über Umgebungsvariablen und Dateien im Projektordner. Diese Anleitung zeigt die Wahl des Images, eine produktionsreife Compose-Datei, die wichtigsten Einstellungen, den Betrieb hinter einem Reverse Proxy und die Installation von Plugins. Wer Grafana lieber als Paket auf Debian installiert, findet das in [[Installation von InfluxDB und Grafana auf Debian 13]].

[[Datei:Grafana-Installation.png|thumb|center|750px|Grafana mit Docker Compose: Container grafana/grafana-enterprise 13.2 (kostenlos, enthält alle Open-Source-Funktionen) auf Port 3000 nur lokal, PostgreSQL 18 statt SQLite für Dashboards, Benutzer und Alarmregeln, Ordner provisioning für Datenquellen und Dashboards, Konfiguration per GF_-Umgebungsvariablen mit Geheimnissen aus Dateien (__FILE), Reverse Proxy mit HTTPS und root_url, Plugins per GF_PLUGINS_PREINSTALL; Admin-Passwort sofort ändern, Registrierung und anonymen Zugriff aus.]]

== Welches Image? ==
{| class="wikitable"
! Image !! Inhalt !! Empfehlung
|-
| <code>grafana/grafana-enterprise</code> || alle Open-Source-Funktionen; Enterprise-Funktionen nach Lizenzaktivierung || vom Hersteller als Standard empfohlen, kostenlos
|-
| <code>grafana/grafana</code> || reine Open-Source-Version (AGPL-3.0) || wenn ausschließlich Open Source gewünscht ist
|-
| <code>grafana/grafana-oss</code> || veraltet || wird seit 12.4 nicht mehr aktualisiert
|}
Die Standard-Images basieren auf Alpine Linux. Immer eine '''feste Version''' wie <code>13.2.4</code> verwenden.

== Schritt 1: Verzeichnisse und Geheimnisse ==
<syntaxhighlight lang="bash">
sudo mkdir -p /opt/grafana/{provisioning/datasources,provisioning/dashboards,secrets,backup} && cd /opt/grafana
openssl rand -base64 24 > secrets/admin_password
openssl rand -hex 24 > secrets/db_password
sudo chmod 600 secrets/*
</syntaxhighlight>

== Schritt 2: Grafana mit Docker Compose konfigurieren ==
<syntaxhighlight lang="yaml">
services:
grafana:
image: grafana/grafana-enterprise:13.2.4
restart: unless-stopped
depends_on: [db]
ports:
- "127.0.0.1:3000:3000"
volumes:
- grafana-data:/var/lib/grafana
- ./provisioning:/etc/grafana/provisioning:ro
- ./secrets:/run/secrets:ro
environment:
GF_SERVER_ROOT_URL: https://grafana.firma.de/
GF_SERVER_DOMAIN: grafana.firma.de
GF_DATABASE_TYPE: postgres
GF_DATABASE_HOST: db:5432
GF_DATABASE_NAME: grafana
GF_DATABASE_USER: grafana
GF_DATABASE_PASSWORD__FILE: /run/secrets/db_password
GF_SECURITY_ADMIN_PASSWORD__FILE: /run/secrets/admin_password
GF_SECURITY_COOKIE_SECURE: "true"
GF_SECURITY_DISABLE_GRAVATAR: "true"
GF_USERS_ALLOW_SIGN_UP: "false"
GF_AUTH_ANONYMOUS_ENABLED: "false"
GF_ANALYTICS_REPORTING_ENABLED: "false"
GF_SMTP_ENABLED: "true"
GF_SMTP_HOST: smtp.firma.de:587
GF_SMTP_FROM_ADDRESS: grafana@firma.de
GF_DATE_FORMATS_DEFAULT_TIMEZONE: Europe/Berlin
GF_PLUGINS_PREINSTALL: alexanderzobnin-zabbix-app

db:
image: postgres:18
restart: unless-stopped
volumes:
- ./pgdata:/var/lib/postgresql
environment:
POSTGRES_DB: grafana
POSTGRES_USER: grafana
POSTGRES_PASSWORD_FILE: /run/secrets/db_password
secrets: [db_password]

secrets:
db_password:
file: ./secrets/db_password

volumes:
grafana-data:
</syntaxhighlight>
* '''Jede Einstellung''' aus <code>grafana.ini</code> lässt sich als Umgebungsvariable <code>GF_<ABSCHNITT>_<SCHLÜSSEL></code> setzen; mit dem Zusatz <code>__FILE</code> liest Grafana den Wert aus einer Datei – Passwörter stehen so nicht in der Compose-Datei.
* '''PostgreSQL statt SQLite''': SQLite reicht für Tests, für mehrere Benutzer, viele Alarmregeln und einen späteren Hochverfügbarkeitsbetrieb ist PostgreSQL robuster. Bei SQLite kann die Speichermigration von Grafana 13 an Sperren scheitern.
* '''Plugins''': <code>GF_PLUGINS_PREINSTALL</code> installiert Plugins beim Start, hier als Beispiel das Zabbix-Plugin. Nur benötigte und gepflegte Plugins installieren.
* '''Telemetrie''': <code>GF_ANALYTICS_REPORTING_ENABLED=false</code> schaltet die anonyme Nutzungsstatistik an Grafana Labs ab.

<syntaxhighlight lang="bash">
docker compose up -d && docker compose logs -f grafana
</syntaxhighlight>

== Schritt 3: Reverse Proxy ==
Grafana lauscht nur lokal; ein [[Reverse Proxy]] stellt <code>https://grafana.firma.de</code> bereit. Beispiel nginx:
<syntaxhighlight lang="nginx">
location / {
proxy_set_header Host $host;
proxy_pass http://127.0.0.1:3000;
}
location /api/live/ {
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_pass http://127.0.0.1:3000;
}
</syntaxhighlight>
* <code>/api/live/</code> ist der WebSocket-Pfad für Live-Aktualisierungen.
* <code>GF_SERVER_ROOT_URL</code> muss der öffentlichen Adresse entsprechen – sonst funktionieren Links in Alarm-Mails und die Anmeldung mit Entra ID nicht. Für einen Unterpfad wie <code>/grafana/</code> zusätzlich <code>GF_SERVER_SERVE_FROM_SUB_PATH=true</code>.
* Grafana gehört ins interne Netz bzw. VPN; nur wenn nötig öffentlich, dann mit SSO und zusätzlichem Schutz.

== Schritt 4: Erste Anmeldung ==
# <code>https://grafana.firma.de</code> öffnen, als <code>admin</code> mit dem Passwort aus <code>secrets/admin_password</code> anmelden.
# Unter ''Administration › Users and access'' persönliche Konten bzw. SSO einrichten, siehe [[Grafana: Benutzer, Rechte und Anmeldung mit Entra ID]]; das Konto <code>admin</code> nur noch als Notfallzugang nutzen.
# Mit dem '''Grafana Advisor''' (im Bereich ''Administration'') die Gesundheitsprüfung der Instanz laufen lassen – er meldet z. B. veraltete Plugins und fehlerhafte Datenquellen.
# Erste Datenquelle anlegen, siehe [[Grafana: Datenquellen und Dashboards erstellen]].

== Updates ==
<syntaxhighlight lang="bash">
cd /opt/grafana
docker compose exec -T db pg_dump -U grafana -Fc grafana > backup/grafana-$(date +%F).dump
# Tag in compose.yaml anheben, dann:
docker compose pull && docker compose up -d && docker compose logs --tail 100 grafana
</syntaxhighlight>
* Patch-Versionen (z. B. 13.2.3 → 13.2.4) enthalten Sicherheitskorrekturen – zeitnah einspielen.
* Beim Wechsel der Haupt- oder Minor-Version die Upgrade-Hinweise lesen; Grafana 13 hat einige Änderungen, die Skripte und Plugins betreffen, siehe [[Grafana: Absichern, Backup und Updates]].
* Ab Grafana 13 heißen die Kommandos <code>grafana cli</code> und <code>grafana server</code>; <code>grafana-cli</code> und <code>grafana-server</code> gibt es nicht mehr.

== Hinweise ==
* '''Bildwiedergabe''' (PNG-Export, Bilder in Alarm-Mails, Berichte) braucht seit Grafana 13 den Image Renderer als eigenen Dienst; das frühere Plugin wird nicht mehr unterstützt.
* '''Hochverfügbarkeit''': Mehrere Grafana-Container mit gemeinsamer PostgreSQL-Datenbank hinter einem Load Balancer sind möglich; für das Alerting dann die HA-Einstellungen beachten.
* Bei Aufbau und Betrieb von Linux-Servern und Containern unterstützt Sie das [https://www.max-it.de/it-services/linux-consulting/ Linux-Consulting von m.a.x. it].

== Siehe auch ==
* [[Grafana im Unternehmen]] – Überblick und alle Artikel der Reihe
* [[Installation von InfluxDB und Grafana auf Debian 13]]
* [[Docker]]
* [[PostgreSQL]]

== Links und Quellen ==
* [https://grafana.com/docs/grafana/latest/setup-grafana/installation/docker/ Grafana-Dokumentation: Run Grafana Docker image]
* [https://www.max-it.de/it-services/linux-consulting/ Linux-Consulting von m.a.x. it]

{{Uebermax}}
[[Kategorie:Server-Software]]

Grafana: Installation mit Docker Compose - Versionsgeschichte

imported>TechCorner-Redaktion: Neuer Artikel: Image-Wahl, Compose mit PostgreSQL, GF_-Variablen und __FILE, Reverse Proxy, Plugins, Updates