Zuletzt aktualisiert: 11.06.2026 · Lesezeit: 6-8 Minuten
Icinga mit Icinga DB auf Ubuntu 26.04 LTS installieren: diese Anleitung führt dich Schritt für Schritt durch die komplette Grundinstallation. Von der Einbindung des Icinga-Repositorys über das Redis-basierte IcingaDB-Setup bis zum Node Wizard. In rund 20 Minuten hast du eine saubere Monitoring-Basis, auf der du direkt aufbauen kannst.
Die wichtigsten Punkte in 30 Sekunden
- Installation läuft ausschließlich über das offizielle Icinga-Repository, die Ubuntu-Standardpakete sind nicht geeignet.
- IcingaDB ist keine eigenständige Datenbank, sondern ein Komponentenverbund aus Redis-Puffer, Icinga-Feature und Daemon.
- Redis lauscht bei Icinga bewusst auf Port 6380 – so gibt es keine Konflikte mit bestehenden Redis-Instanzen.
- Wer
bind 0.0.0.0setzt, muss Redis zwingend absichern: Passwort, Firewall oder TLS. - Der Node Wizard legt Zonen und Endpunkte fest und schließt die Grundinstallation ab.
Voraussetzungen für die Installation
Bevor du mit der Installation von Icinga auf Ubuntu 26.04 startest, sollte deine Umgebung folgende Voraussetzungen erfüllen:
- Betriebssystem: Ubuntu Desktop 26.04 LTS mit mind. 6 GB RAM und 25 GB freiem Speicherplatz & Ubuntu Server 26.04 LTS mit mind. 2 GB RAM und 20 GB Speicherplatz
- Du hast das Recht, als Sudo-Benutzer auf dieser Maschine zu arbeiten
- Zugriff auf eine SQL-Datenbank
- Eine Internetverbindung auf der Maschine
Schritt 1: Einbindung des Icinga-Repositiory
Um die aktuelle Version von Icinga installieren zu können, benötigst du das offizielle Icinga-Repository. Zu Beginn wirst du die Liste der verfügbaren Softwarepakete aktualisieren. Dazu führst du in deinem Terminal folgende Befehle aus:
System aktualisieren:
apt updateGPG-Schlüssel installieren:
wget -O icinga-archive-keyring.deb "https://packages.icinga.com/icinga-archive-keyring_latest+ubuntu$(
. /etc/os-release; echo "$VERSION_ID"
).deb"wget -O icinga-archive-keyring.deb "https://packages.icinga.com/icinga-archive-keyring_latest+ubuntu$(
. /etc/os-release; echo "$VERSION_ID"
).deb"apt install ./icinga-archive-keyring.debRepository eintragen:
echo "deb [signed-by=/usr/share/keyrings/icinga-archive-keyring.gpg] https://packages.icinga.com/ubuntu icinga-resolute main"> /etc/apt/sources.list.d/resolute-icinga.list
echo "deb-src [signed-by=/usr/share/keyrings/icinga-archive-keyring.gpg] https://packages.icinga.com/ubuntu icinga-resolute main">> /etc/apt/sources.list.d/resolute-icinga.listPaketlisten neu einlesen:
apt updateDie neuen Repositories sind in deiner Liste sichtbar, sobald der Befehlsblock ohne Fehler abgeschlossen wurde.
Schritt 2: Icinga-Paket installieren
Um im nächsten Schritt das Icinga-Paket zu installieren, benutzt du:
apt install icinga2 -y Schritt 3: Installation des Monitoring-Plugins und Aktivierung der Icinga-API
Der folgende Schritt ermöglicht es dir, durch die Installation der Monitoring-Plugins die ersten Checks anzulegen und Daten zu sammeln.
Schritt 3: Installation des Monitoring-Plugins und Aktivierung der Icinga-APIapt install monitoring-pluginsUm nun die Ergebnisse der Check-Plugins abzurufen, muss die Icinga-API eingerichtet werden. Das erste Kommando aktiviert das API-Feature und erstellt automatisch X.509-TLS-Zertifikate für eine sichere Kommunikation. Außerdem wird ein API-Benutzer in der Konfigurationsdatei erstellt.
/etc/icinga2/conf.d/api-users.conf Standardmäßig ist der Nutzer hier root, das Passwort wird zufällig generiert. Aus Sicherheitsgründen Empfehle ich die Parameter individual zu ändern.
Der Neustart des Dienstes lässt die neuen Konfigurationen laden und aktiviert sie.
icinga2 api setup
systemctl restart icinga2Lieber von Anfang an richtig aufsetzen?
Unsere Consultants begleiten dich von der Grundinstallation bis zur produktiven HA-Umgebung, inklusive Absicherung, Backup und Monitoring-Onboarding.
Consulting anfragen →
Schritt 4: Icinga DB einrichten
Icinga DB ist, anders als der Name vielleicht vermuten lässt, keine eigenständige Datenbank.
Vielmehr ist es eine Sammlung von Komponenten zur Veröffentlichung, Synchronisierung und Visualisierung von Überwachungsdaten im Icinga-Ökosystem. Zu diesen Komponenten gehören Redis, das IcingaDB-Feature des Icinga Core und der IcingaDB-Daemon.
Um Icinga DB nutzen zu können, benötigst du einen Redis-Server. Redis steht für „Remote Dictionary Server”. Es handelt sich dabei um eine In-Memory-Datenbank. Icinga hat diese so optimiert, dass sie perfekt in die Icinga 2-Infrastruktur passt.
Er speichert Ergebnisse, Downtimes temporär und reduziert so die Last auf der Haupt-Datenbank. Icinga 2 nutzt anstelle des üblichen Redis-Ports 6379 den Port 6380. Dieser wird automatisch bei der Installation gesetzt.
apt install icingadb-redis
systemctl enable --now icingadb-redis-serverStandardmäßig lauscht icingadb-redis nur auf 127.0.0.1, also auf localhost. Damit du in Zukunft auch weitere Nodes einbinden kannst ändern wir dafür folgende Konfigurationsdatei:
/etc/icingadb-redis/icingadb-redis.confIn dieser Datei passt du den Punkt „bind“ an: bind 127.0.0.1 wird bind 0.0.0.0
Damit können alle Interfaces auf den Redis zugreifen.
Sicherheitshinweis: Redis verfügt standardmäßig über keine aktive Authentifizierung. Wenn du bind auf 0.0.0.0 änderst und dein System extern kommuniziert, kann dies unbefugten Zugriff ermöglichen. Um diese Sicherheitslücke zu schließen, solltest du verschiedene Sicherheitsvorkehrungen treffen.
Dazu gehört beispielsweise, ein Passwort einzurichten, Firewall-Regeln aufzustellen oder TLS zu aktivieren.
In diesem Guide wird jedoch darauf verzichtet, um die Verständlichkeit zu erhöhen und den Umfang zu reduzieren. Es wird jedoch dringend empfohlen, auch diese Anpassungen nachträglich vorzunehmen.
systemctl restart icingadb-redisMit dem Befehl starten wir den Service neu und die Änderungen werden aktiviert.
Damit Icinga über die Icinga DB Daten über den Redis verarbeiten kann, muss das entsprechende Feature freigegeben werden. Anschließend muss Icinga 2 neugestartet werden.
icinga2 feature enable icingadb
systemctl restart icinga2Installation der IcingaDB und Einrichten der Datenbank
Nachdem die Schnittstelle zwischen Icinga 2 und Icinga DB aktiviert wurde, wird nun Icinga DB installiert.
apt-get install icingadbIn diesem Beispiel nutze ich MySQL, um eine Datenbank für IcingaDB zu erstellen.
Hinweis: Alternativ kannst du auch MariaDB oder PostgreSQL verwenden. Für PostgreSQL weichen die Befehle ab. Die entsprechenden Schritte findest du in der offiziellen Icinga Dokumentation.
mysql -u root -p
CREATE DATABASE icingadb;
CREATE USER 'icingadb'@'localhost' IDENTIFIED BY 'DeinSicheresPasswort';
GRANT ALL ON icingadb.* TO 'icingadb'@'localhost';Somit hast du die Datenbank und den Datenbank-Nutzer erfolgreich angelegt. IcingaDB stellt zudem ein Datenbankschema zur Verfügung, das nun importiert wird:
mysql -u root -p icingadb </usr/share/icingadb/schema/mysql/schema.sqlZugriffsberechtigungen anpassen
Während der Installation von Icinga DB wird die Konfigurationsdatei /etc/icingadb/config.yml mit Standardwerten angelegt. Damit die Verbindung von Icinga DB zu Redis und MySQL erfolgreich hergestellt werden kann, müssen diese Werte überprüft und gegebenenfalls angepasst werden.
Öffne dazu den Pfad mit einem Texteditor deiner Wahl und passe die folgenden Parameter gegebenenfalls an:
Für die Datenbank sind dies: Host mit dem entsprechenden Hostnamen/der entsprechenden Host-IP deiner Datenbank, Database mit dem Namen deiner Datenbank, User mit dem Namen deines Datenbanknutzers und Password mit dem Passwort, das du für deine Datenbank vergeben hast.
Für Redis: host mit dem entsprechenden Hostname/Host-IP deiner Redis-Instanz. Wenn du während der Installation deines Redis-Servers den Port geändert oder ein Passwort gesetzt hast, musst du dies hier ebenfalls eintragen.
Sobald diese Änderungen abgeschlossen sind, kannst du den IcingaDB-Service aktivieren.
systemctl restart icingadb
systemctl enable --now icingadbSchritt 5: Node Wizard
Der Node Wizard hilft dir dabei, deine Zonen einzustellen und die Endpunkte deines Icinga-Monitorings festzulegen. Hierfür nutzt du:
icinga2 node wizardDie Abfragen erscheinen auf Englisch, hier sind die entsprechenden Antworten:
- Is this agent/satellite setup? –> Hier ’n‘ eingeben und mit Enter bestätigen
- Specifiy common name (FQDN of your master) –> Nichts eingeben und mit Enter bestätigen
- Master zone name –> Nichts eingeben und mit Enter bestätigen
- Specify additional global zones –> Nichts eingeben und mit Enter bestätigen
- Specify API bind host/port –> Nichts eingeben und mit Enter bestätigen
- Bind Host –> Nichts eingeben und mit Enter bestätigen
- Bind Port –> Nichts eingeben und mit Enter bestätigen
- Disable inclusion of conf.d directory –> Nichts eingeben und mit Enter bestätigen
Um nun die Konfiguration zu verifizieren und anschließend Icinga 2 neu zu laden, gehe wie folgt vor:
icinga2 daemon -C
systemctl reload icinga2
Fertig! Die Grundinstallation von Icinga mit IcingaDB auf Ubuntu 26.04 ist abgeschlossen.
Im nächsten Artikel geht es weiter mit der Installation von Icingaweb2 und Icinga DB Web. Weitere Guides zu Icinga Installationen findest du in der Übersicht.
