Zuletzt aktualisiert: 09.04.2026
Viele Nutzer möchten ihr Monitoring nicht nur über die Konsole verwalten, sondern auch grafisch auswerten. Mit Icinga2 und Icinga Web steht dafür eine moderne Oberfläche bereit, in der sich Abläufe und Checks komfortabel visualisieren lassen.
Wenn du bereits meinen Guide zur Installation von Icinga2 und IcingaDB aus dem Teil 1 dieser Serie durchgeführt hast, kannst du hier direkt weiter machen. Falls nicht, empfiehlt es sich, zunächst mit der Basisinstallation zu starten.
Schritt-für-Schritt Anleitung zur Installation von Icingaweb & Icinga DB-Web auf Ubuntu 24.04
In dieser Anleitung zeige ich dir Schritt für Schritt, wie du Icingaweb mit IcingaDB-Web installierst und konfigurierst.
Voraussetzungen für die Installation
Für die Installation von Icinga DB-Web auf Ubuntu 24.04 müssen die folgenden Voraussetzungen erfüllt sein. Zunächst benötigst du eine bereits vorhandene Icinga-Instanz bestehend aus:
- Ubuntu 24.4 LTS
- Icinga2, IcingaDB, IcingaDB-Redis und MySQL/MariaDB/PostgreSQL
- Einen Sudo-Benutzer, der auf der Maschine eingerichtet ist und genutzt werden darf
- Eine funktionierende Internetverbindung
- Einen installierten Webserver (in meinem Fall nutze ich Apache)
Schritt 1: Icingaweb installieren und konfigurieren
Bevor du beginnst, sollte bereits ein Benutzer für Icinga Web vorhanden sein. Keine Sorge, wenn du den ersten Teil mit mir gemacht hast, ist dieser bereits eingerichtet.
Mit dem folgenden Befehl installierst du ein Modul für die grafische Oberfläche:
apt-get install -y icingadb-webDabei werden automatisch auch die icingacli und libapache2-mod-php installiert. Beide Abhängigkeiten sind wichtig. Kurz erklärt:
- libapache2-mod-php ermöglicht es uns PHP Dateinen (.php) direkt in den Apache-WEbserver zu verarbeiten.
- Icingacli ist die Kommandozeilenschnittstelle zur Verwaltung und Konfiguration von Icinga Web 2.
Als Nächstes erzeugst du einen Setup-Token, der für die webbasierte Einrichtung benötigt wird:
icingacli setup token create Falls du den Token später erneut aufgerufen werden muss, kannst du folgenden Befehl verwenden:
icingacli setup token show Schritt 2: Icinga Web Datenbank anlegen
Eine vollautomatische installation ist nicht möglich, da bestimmte Systemressourcen dies aus Sicherheitsbeschränkungen nicht zulassen.
Daher ist das Anlegen der Icinga Web Datenbank und des dazugehörigen Nutzers unser nächster Schritt. Ich nutze MySQL als Datenbank, für MariaDB ist der selbe Befehl möglich. Die Erstellung ist unter PostgreSQL ebenfalls möglich.
mysql -u root -p
CREATE DATABASE icingaweb2;
CREATE USER 'icingaweb2'@'localhost' IDENTIFIED BY 'DeinSicheresPasswort';
GRANT ALL ON icingaweb2.* TO icingaweb2@localhost;Schritt 3: Einrichten von Icinga Web im Browser
Um das Icinga Web 2 Setup zu starten, rufst du die IP-Adresse deiner Icinga-Instanz im Browser auf und fügst /icingaweb2/setup hinten an. Deine IP-Adresse kannst du mit ip a einsehen.
Im Setup-Prozess gibst du zunächst den zuvor generierten Token ein.
Icinga Module wählen
Auf dieser Seite wählst du aus den fünf vorgeschlagenen Modulen die aus, die du nutzen willst. Standardmäßig ist bereits das Icingadb Modul ausgewählt, was beibehalten werden muss!
WICHTIG: Da wir eine aktuelle Installation von Icinga 2 und Icinga Web 2 durchführen, kommt Icinga DB anstelle der bisher verwendeten IDO zum Einsatz. Von daher kann auf das Modul Monitoring verzichtet werden!
Icinga Web PHP Module überprüfen
Hier bekommst du eine Übersicht über alle vorhandenen Bauteile und ihren jeweiligen Status.
Authentifizierungsmethode wählen
In diesem Abschnitt ist es dir möglich, eine aus drei Authentifizierungsmethoden festzulegen. LDAP, External oder wie in unserem Fall Database.
Diese werden im nächsten Schritt ausgefüllt:
Datenbank-Authentifizierung
Hier definierst du die Verbindung zur zuvor erstellten Datenbankressource und wählst den Datenbanktyp aus. Solltest du den Host oder den Port angepasst haben, trage die entsprechenden Werte ein. Datenbankname, Benutzername und das Passwort haben wir unter Schritt 2 festgelegt.
Möchtest du es zusätzlich mit SSL verschlüsseln, kannst du den Button anklicken und deine Daten eintragen.
Drückst du nun auf Prüfen, erscheint wie hier im Beispiel ein Textfenster, das dir deine Einstellung vorab prüft. Hat dies funktioniert, geht es weiter.
Icinga Web Backend Authentifizierung
Wir haben angegeben eine Datenbank für die Authentifizierung zu nutzen (unsere Datenbankressource). Diese muss nun definiert werden.
Icinga Web Admin User anlegen
Lege nun einen Administrator-Zugang für Icinga Web 2 an. Benutzername und Passwort können frei gewählt werden.
Icinga Web Konfiguration der Anwendung
Auf dieser Seite hast du die Möglichkeit, ein paar individuelle Konfigurationen an der Anwendung so wie dem Loggingverhalten von Icinga Web 2 vorzunehmen. Für diesen Guide werden die Standardeinstellungen beibehalten.
Zusammenfassung der bisherigen Konfiguration
Du bekommst noch einmal eine Übersicht von allen angegebenen Einstellungen. Bist du mit diesen zufrieden und dir sind keine Fehler aufgefallen, drücke auf weiter.
IcingaDB-Web konfigurieren
Nach der Einrichtung von Icinga Web 2 folgt nun die Konfiguration von IcingaDB Web. Es folgen 5 Schritte, durch die du im Anschluss Icinga2 starten kannst.
Folge dem Wizard auf die nächste Seite. Hier musst du die Datenbank-Daten von IcingaDB eingeben. Diese haben wir zu Beginn erstellt. Die Anleitung dazu findest du im Guide „Icinga mit IcingaDB”.
Prüfe die Einstellungen, um Fehler vorzubeugen und ein spätere Fehlersuche zu vermeiden.
Redis Informationen bereitstellen
Im folgendem Fenster wird nun die Verbindung mit dem IcingaDB Redis hergestellt. Wie bei der Datenbank werden hier die Zugangsdaten eingeben und die Konfiguration geprüft.
Hinweis: Da während der Einrichtung von Redis auf ein Passwort verzichtet wurde, kann das Feld hier ebenfalls freigelassen werden.
Icinga API mit Icinga Web verbinden
Der letzte Schritt vor dem erfolgreichen Abschluss der Konfiguration von Icinga Web ist das Herstellen der Verbindung von Icinga Web zur Icinga 2 API.
Standardmäßig wird root als API Username festgelegt. Diesen Benutzer und das Passwort findest du aber auch unter /etc/icinga2/conf.d/api-users.conf
Auch hier kannst du die eingegebenen Parameter noch einmal prüfen lassen.
Gesamtübersicht & Abschluss der Einrichtung
Zum Abschluss erhältst du eine Gesamtübersicht aller eingegebenen Parameter. Prüfe nochmals alle Eingaben und drücke auf Fertigstellen.
Deiner Ersten Anmeldung steht nun nichts mehr im Wege. Außer dem Passwort… 😉
Herzlichen Glückwunsch, du hast Icinga Web 2 erfolgreich eingerichtet und mit IcingaDB verbunden!
Wenn du Unterstützung bei der Einrichtung oder Erweiterung deiner Umgebung benötigst, kannst du dich jederzeit an unser Team wenden. Du erreichst uns per E-Mail per sales@netways.de, über unser Kontaktformular oder auch telefonisch!
