We use cookies to ensure that we give you the best experience on our website.  Visit our Privacy Policy to learn more. If you continue to use this site, we will assume that you are okay with it.

Your choices regarding cookies on this site.
Your preferences have been updated.
In order for the changes to take effect completely please clear your browser cookies and cache. Then reload the page.

Installation on Debian and Ubuntu

Checkmk Manual
Last updated: June 23 2020

Search in the manual

1. Download the appropriate packages

If you have a subscription, on your subscription downloads page you will find a suitable RPM or DEB package for your distribution for every available Checkmk-Version. For a free test or small installations of Checkmk you can use our free Editions. these don't need in consequence any subscription. You are still able to do an upgrade any time to go to on of the  Checkmk Enterprise Editions on a later on.

Please consider when selecting a package:

  • Firstly, choose a version of Checkmk, a distribution and the version of this distribution.
  • We recommend the latest stable version. If you need an older version anyway, you can find these in download archive at the of the page.
  • The name and version of your distribution must be strictly identical.
  • Choose one of the Editions. If you're unsure, you can get an overview to the differences of the editions.

After you downloaded the package to your machine, you need to copy the file to the target Linux system where Checkmk needs to be installed. You can do that for example with the program WinSCP or – if you are able to use ssh connections – with the command line tool scp.

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

root@linux# apt-get install openssh-server

Once this is done you can copy for example the package of the  Checkmk Raw Edition for Ubuntu 20.04 (focal fossa) using the command below:

root@linux# scp check-mk-raw-1.6.0p12_0.focal_amd64.deb root@mymonitoring.mydomain.org:

2. Signed-package installation

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.

Depending on which optional packages were installed during the setup of your distribution, you will have to install dpkg-sig including all its dependencies. To do so, just enter the following command:

root@linux# apt-get install dpkg-sig

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

root@linux# wget https://checkmk.com/support/Check_MK-pubkey.gpg

Alternatively, the key can also be obtained from gnupg.net:

root@linux# gpg --keyserver keys.gnupg.net --recv-keys 434DAC48C4503261
root@linux# gpg --armor --export 434DAC48C4503261 > Check_MK-pubkey.gpg

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

root@linux# apt-key add Check_MK-pubkey.gpg

Once the key has been added, you can verify the Checkmk-package using the following command:

root@linux# dpkg-sig --verify check-mk-enterprise-1.6.0p13_0.buster_amd64.deb

Next install the package gdebi-core. This tool ensures that not only the package with the Checkmk Monitoring System, but also all of its dependencies will be correctly installed:

root@linux# apt-get install gdebi-core

Afterwards install the Checkmk-package using gdebi:

root@linux# gdebi check-mk-enterprise-1.6.0p13_0.buster_amd64.deb

3. Final test

After the successful installation of Checkmk, and all 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:

root@linux# omd version
OMD - Open Monitoring Distribution Version 1.6.0p13.cee