Installation unter Debian und Ubuntu

Minimalinstallationen von Debian oder Ubuntu enthalten möglicherweise nicht alle für die Installation von Checkmk benötigten Paketquellen. Vergleichen Sie die folgenden Minimalanforderungen mit den Einträgen Ihrer /etc/apt/sources.list, beziehungsweise dem Inhalt des Verzeichnisses /etc/apt/sources.list.d. Unsere Beispiele verwenden die mehrzeilige Schreibweise und greifen auf den zentralen Spiegelserver zu. Sofern nicht anders angegeben, gelten für ältere Versionen und STS-Versionen (Short Term Support) die selben Anforderungen. Tauschen Sie in diesem Fall einfach den Codenamen aus. Aktualisieren Sie nach Überprüfung oder Anpassung der Paketquellen den lokalen Paket-Index:

Wählen Sie zunächst die für Ihre Bedürfnisse passende Checkmk-Edition. Auf der Download-Seite finden Sie die Raw Edition, welche Open Source ist, und die bis 750 Services gratis nutzbare Cloud Edition. Wenn Sie eine Subskription besitzen, dann finden Sie die Installationspakete im Kundenportal.

Wir empfehlen den Einsatz der letzten stabilen Checkmk-Version. Falls Sie (beispielsweise als Basis für die Wiederherstellung eines Backups) eine ältere Version benötigen, finden Sie diese im Download-Archiv. Achten Sie darauf, dass das ausgewählte Paket exakt zur installierten Linux-Distribution und deren Version passt.

Nachdem Sie das Paket heruntergeladen haben, bringen Sie es auf das Linux-System, auf dem Checkmk installiert werden soll. Das kann zum Beispiel über das Kommandozeilentool scp geschehen, welches jedes moderne System mitbringt – und auch bei Windows 10 in der PowerShell verfügbar ist. Zusätzliche Programme wie WinSCP sind meist nicht erforderlich.

Für eine Übertragung mit scp muss auf dem zukünftigen Checkmk-Server das Paket openssh-server installiert sein. Sollte dies noch nicht der Fall sein, so führen Sie den folgenden Befehl aus, um das Paket zu installieren:

Anschließend können Sie beispielsweise die Checkmk Raw Edition für Ubuntu 22.04 Jammy Jellyfish wie folgt übertragen:

Alle Pakete werden mittels GnuPG signiert. Durch diese Signatur können Sie zum einen prüfen, ob das Paket auch wirklich von uns stammt, und zum anderen, ob es insgesamt vollständig ist.

Je nachdem mit welchen optionalen Paketen Ihre Distribution installiert wurde, muss für eine erfolgreiche Verifikation noch das Paket dpkg-sig inklusive seiner Abhängigkeiten installiert werden. Führen Sie dazu den folgenden Befehl aus:

Damit die signierten Pakete wie gewohnt installiert werden können, müssen Sie einmalig unseren öffentlichen Schlüssel importieren, damit der Signatur vertraut wird. Laden Sie dazu zuerst den Schlüssel direkt von unserer Website:

Danach importieren Sie den Schlüssel in die Liste der vertrauenswürdigen Signaturen. Unter Debian und Ubuntu benötigen Sie dafür den folgenden Befehl:

Sobald Sie den Schlüssel importiert haben, verifizieren Sie das Checkmk-Paket mit dem folgenden Befehl:

In einigen Fällen scheitert die Signaturprüfung mit der folgenden Fehlermeldung:

Tritt dies auf, ist der wahrscheinlichste Grund, dass die installierte Version von dpkg-sig nicht mit dem Kompressionsformat des Pakets umgehen kann. Verwenden Sie in diesem Fall gpg, um die Signatur zu prüfen:

Die angezeigte Warnung bezieht sich auf den öffentlichen Schlüssel von Checkmk, nicht die Signatur des Pakets selbst. Der Grund hierfür ist, dass der verwendete Schlüssel mit keinem anderen Schlüssel signiert ist, dem der Nutzer vertraut - was aber in diesem Fall kein Problem darstellt.

Anschließend können Sie das Checkmk-Paket mit dem folgenden Befehl installieren. Achten Sie dabei darauf, den vollständigen Pfad zu der DEB-Datei an apt install zu übergeben:

Nach der erfolgreichen Installation von Checkmk und allen Abhängigkeiten steht Ihnen der Befehl omd zur Verfügung, mit dem Sie Monitoring-Instanzen anlegen und verwalten können. Zur Kontrolle können Sie die installierte Version ausgeben lassen: