Quelltext der Seite Zabbix: Installation mit PostgreSQL und TimescaleDB

{{Steckbrief
| gilt_fuer   = Zabbix 7.0 LTS (bzw. 7.4) auf Debian 13 „Trixie“ mit PostgreSQL 17, optional TimescaleDB, nginx und PHP 8.4; Pakete aus dem Zabbix-Repository
| bereich     = Server-Software
| dauer       = ca. 1 Stunde
| rechte      = Root bzw. sudo auf dem Debian-Server
| stand       = Oktober 2026
}}
'''Zabbix mit PostgreSQL und TimescaleDB installieren''' ist die empfehlenswerte Grundlage für ein Monitoring, das über Jahre wächst: Zabbix-Server, Weboberfläche und Agent kommen als Pakete aus dem offiziellen Repository, die Messdaten liegen in PostgreSQL, und die Erweiterung TimescaleDB komprimiert alte Werte und beschleunigt das Aufräumen. Diese Anleitung zeigt die Installation von Zabbix 7.0 LTS auf Debian 13 Schritt für Schritt, die Größenplanung und die ersten Einstellungen nach dem Login.

[[Datei:Zabbix-Installation.png|thumb|center|750px|Installation von Zabbix 7.0 LTS auf Debian 13: Paket zabbix-release aus repo.zabbix.com, Pakete zabbix-server-pgsql, zabbix-frontend-php, zabbix-nginx-conf, zabbix-sql-scripts, zabbix-agent2; PostgreSQL 17 mit Benutzer und Datenbank zabbix, Schema importieren, optional TimescaleDB mit Komprimierung; Konfiguration in zabbix_server.conf und nginx.conf; Weboberfläche über HTTPS, Erstanmeldung Admin/zabbix sofort ändern; Größen: 1.000 Metriken 2 vCPU und 8 GB RAM, 10.000 Metriken 4 vCPU und 16 GB.]]

== Voraussetzungen ==
{| class="wikitable"
! Größe !! Überwachte Metriken !! vCPU !! RAM
|-
| klein || bis 1.000 || 2 || 8 GB
|-
| mittel || bis 10.000 || 4 || 16 GB
|-
| groß || bis 100.000 || 16 || 64 GB, Datenbank auf eigenem Server
|}
* Eine Metrik entspricht grob einem Item mit Trigger und Graph. Ein Linux-Server mit Standardvorlage bringt etwa 100–200 Items, ein Switch mit 48 Ports deutlich mehr.
* '''Speicher''': schnelle SSDs für die Datenbank; der Platzbedarf hängt von Anzahl Items, Abfrageintervall und Aufbewahrung ab.
* '''Unterstützt''' (7.0 LTS): PostgreSQL 13–18, TimescaleDB 2.13–2.29, MySQL 8.0.30–9.7, MariaDB 10.5–12.3, PHP 8.0–8.5, nginx ab 1.20 oder Apache 2.4.
* '''Ports''': 10051/TCP zum Server (aktive Agenten, Proxys), 10050/TCP zu den Agenten (passive Checks), 443 für die Weboberfläche.

== Schritt 1: Zabbix-Repository einbinden ==
<syntaxhighlight lang="bash">
wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest_7.0+debian13_all.deb
sudo dpkg -i zabbix-release_latest_7.0+debian13_all.deb
sudo apt update
sudo apt install zabbix-server-pgsql zabbix-frontend-php php8.4-pgsql zabbix-nginx-conf zabbix-sql-scripts zabbix-agent2 postgresql
</syntaxhighlight>
Für Zabbix 7.4 liegt das Release-Paket unter <code><nowiki>https://repo.zabbix.com/zabbix/7.4/release/debian/</nowiki></code>. Die Pakete von Debian selbst sind meist veraltet und sollten nicht genutzt werden.

== Schritt 2: Datenbank anlegen ==
<syntaxhighlight lang="bash">
sudo -u postgres createuser --pwprompt zabbix
sudo -u postgres createdb -O zabbix zabbix
zcat /usr/share/zabbix/sql-scripts/postgresql/server.sql.gz | sudo -u zabbix psql zabbix
</syntaxhighlight>
Das Passwort im Passwortmanager ablegen.

=== Optional: TimescaleDB ===
TimescaleDB speichert die Verlaufstabellen in Zeitblöcken, '''komprimiert''' ältere Daten (oft auf einen Bruchteil) und löscht abgelaufene Daten blockweise statt zeilenweise.
# TimescaleDB-Pakete aus dem Repository von Timescale passend zur PostgreSQL-Version installieren.
# In <code>postgresql.conf</code> <code>shared_preload_libraries = 'timescaledb'</code> setzen, PostgreSQL neu starten.
# Erweiterung aktivieren und Zabbix-Schema umstellen:
<syntaxhighlight lang="bash">
echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix
cat /usr/share/zabbix/sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix
</syntaxhighlight>
Danach unter ''Administration › Housekeeping'' die Komprimierung aktivieren (z. B. Daten älter als 7 Tage).

== Schritt 3: Server und Weboberfläche konfigurieren ==
<code>/etc/zabbix/zabbix_server.conf</code>:
<syntaxhighlight lang="ini">
DBName=zabbix
DBUser=zabbix
DBPassword=<Passwort>
# Größere Umgebungen: Cache und Poller anpassen
CacheSize=256M
</syntaxhighlight>
<code>/etc/zabbix/nginx.conf</code>: <code>listen</code> und <code>server_name</code> setzen (z. B. <code>zabbix.firma.lan</code>). Für HTTPS ein Zertifikat einbinden oder einen [[Reverse Proxy]] davorschalten.
<syntaxhighlight lang="bash">
sudo systemctl restart zabbix-server zabbix-agent2 nginx php8.4-fpm
sudo systemctl enable zabbix-server zabbix-agent2 nginx php8.4-fpm
</syntaxhighlight>

== Schritt 4: Einrichtungsassistent und erste Anmeldung ==
# <code>https://zabbix.firma.lan</code> aufrufen; der Assistent prüft die PHP-Voraussetzungen, fragt die Datenbankverbindung ab und legt den Servernamen und die Zeitzone ''Europe/Berlin'' fest.
# Anmelden mit '''Admin''' / '''zabbix''' und das Passwort '''sofort ändern'''.
# Unter ''User settings › Profile'' kann die Sprache auf Deutsch gestellt werden (Paket <code>locales</code> mit <code>de_DE.UTF-8</code> nötig). Die deutsche Übersetzung ist allerdings unvollständig und teils missverständlich (z. B. „Verwaltung“ für ''Housekeeping''); viele Administratoren bleiben bei Englisch. '''Die Menüpfade in dieser Reihe folgen der englischen Oberfläche.'''
# Mehr-Faktor-Anmeldung einrichten und persönliche Administratorkonten anlegen, siehe [[Zabbix: Benutzer, Rollen, MFA und SSO mit Entra ID]].
# Den Zabbix-Server selbst überwacht der lokale Host ''Zabbix server'' mit der Vorlage ''Zabbix server health'' – unter ''Monitoring › Problems'' sollte nach wenigen Minuten nichts Rotes stehen.

== Erste Einstellungen ==
* ''Administration › General'': unter ''GUI'' Zeitzone und Standardsprache, unter ''Trigger severity'' die Bezeichnungen der Schweregrade, unter ''Other'' die Frontend-URL (für Links in Benachrichtigungen).
* ''Administration › Housekeeping'': Aufbewahrung für Verlauf (z. B. 90 Tage) und Trends (z. B. 2 Jahre) – Trends sind stündliche Mittelwerte und brauchen wenig Platz.
* ''Data collection › Host groups'': Struktur nach Standort und Funktion, z. B. ''Standort Hamburg/Server'', ''Netzwerk/Switches''.
* ''Alerts › Media types'': E-Mail und Microsoft Teams einrichten, siehe [[Zabbix: Trigger, Benachrichtigungen und Microsoft Teams]].
* Die Prüfung auf Softwareupdates ist seit 7.0 standardmäßig aktiv; sie lässt sich in der Serverkonfiguration abschalten.

== Hinweise ==
* '''Docker''': Offizielle Container-Images (Server, Weboberfläche, Proxy, Agent) gibt es ebenfalls; für den Produktivbetrieb mit viel Datenbanklast ist die Paketinstallation auf einer eigenen VM übersichtlicher.
* '''Datenbank getrennt''': Ab etwa 10.000 Metriken lohnt ein eigener Datenbankserver; die Datenbank ist fast immer der Engpass.
* '''Version festhalten''': Server, Proxys und Weboberfläche müssen dieselbe Hauptversion haben. Agenten dürfen älter sein.
* Bei Aufbau und Betrieb von Linux-Servern unterstützt Sie das [https://www.max-it.de/it-services/linux-consulting/ Linux-Consulting von m.a.x. it].

== Siehe auch ==
* [[Zabbix]] – Überblick und alle Artikel der Reihe
* [[Zabbix: Agent 2 auf Linux und Windows ausrollen]]
* [[PostgreSQL]]
* [[Installation von InfluxDB und Grafana auf Debian 13]]

== Links und Quellen ==
* [https://www.zabbix.com/documentation/7.0/en/manual/installation/requirements Zabbix-Dokumentation: Requirements]
* [https://www.max-it.de/it-services/linux-consulting/ Linux-Consulting von m.a.x. it]

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