Installation on Debian and Ubuntu

Minimal installations of Debian or Ubuntu may not contain all of the required package sources for the installation of Checkmk. Compare the following minimum requirements with the entries in your /etc/apt/sources.list, or the contents of the /etc/apt/sources.list.d directory. Our examples use multi-line notation and access the central mirror server.

Update the local package index after checking or adapting the package sources:

First choose the Checkmk edition that suits your needs. On the download page you will find Checkmk Raw, which is Open Source, and Checkmk Cloud, which is free to use for up to 750 services. If you have a subscription, then you will find the installation packages in the customer portal.

We recommend the use of the latest stable Checkmk version. If you need an older version (for example, as the basis for restoring a backup), you can find it in the download archive. Make sure that the package you select exactly matches the installed Linux distribution and its version.

After you have downloaded the package, bring it to the Linux system on which Checkmk is to be installed. This can be done, for example, via the scp command line tool, which comes with every modern system — and which is also available in PowerShell since Windows 10. Additional programs such as WinSCP are usually not required.

The openssh-server package needs to be installed to be able to copy files to your future Checkmk server using the scp command. If that is not already the case, you can install this using the following command:

Once this has been done you can, for example, copy the Checkmk Raw package for Ubuntu 22.04 Jammy Jellyfish using the below command:

All packages are signed using GnuPG. Through the use of this signature, on the one hand it can be verified whether the package really is from Checkmk, and on the other hand it can be verified that the package is complete.

So that these signed packages can be installed in the usual way, as a one time only action you will need to import our public key so that the signature will be trusted. First, load the key directly from our website:

Then import the key to the list of trusted signatures. Under Debian and Ubuntu the following command is required:

Once you have imported the key, you can verify the package with gpg:

The output line with Good signature is the proof that the package file was signed with the previously downloaded and imported Check_MK-pubkey.gpg key. The displayed warning refers only to the Checkmk public key, not to the signature of the package. The reason for the warning is that the key used is not signed with any other key that the user already trusts — but this is not a problem in this case.

Afterwards you can install the Checkmk package using the following command. Be sure to pass the full file path to the DEB file after apt install:

After the successful installation of Checkmk, and all of its dependencies, you will have access to the omd command. With this command you are able to create and manage monitoring sites. You can request the installed version to verify your installation: