• Introduction
  • Contributing
  • Issues
• Getting started
  • Installation
    • Use another version
  • Quickstart
    • Volumes
• Updates

Dockerfile to create a Docker container image for Check_MK.

Check_MK is comprehensive IT monitoring solution in the tradition of Nagios.

This docker images is based on the Check_MK Raw Edition - a free and 100% open-source version.

The Check_MK Raw Edition is a full-blown IT monitoring solution.

If you find this image useful you can help. - Send a pull request with your awesome features and bug fixes

Before reporting your issue please try updating Docker to the latest version and check if it resolves the issue. Refer to the Docker installation guide for instructions.

SELinux users should try disabling SELinux using the command setenforce 0 to see if it resolves the issue.

Automated builds of the image are available on Dockerhub and is the recommended method of installation.

docker pull nlmacamp/check_mk:1.5.0p2    (or nlmacamp/check_mk:latest)

Alternatively you can build the image yourself.

docker build -t nlmacamp/check_mk github.com/viper0131/check_mk

If you want to change the version of check_mk, use --build-arg CMK_VERSION_ARG=1.5.0p2 --build-arg CMK_DOWNLOADNR_ARG=38.

To get the version and downloadnr, go to https://mathias-kettner.com/download.php and select your version (CRE). Select Red Hat / CentOS 7.x and right click on "Download" link and select "Copy link" (or similar).

On clipboard you should have something like this:

https://mathias-kettner.de/support/1.5.0p2/check-mk-raw-1.5.0p2-el7-38.x86_64.rpm

Generally:

https://mathias-kettner.de/support/<CMK_VERSION_ARG>/check-mk-raw-<CMK_VERSION_ARG>-el7-<CMK_DOWNLOADNR_ARG>.x86_64.rpm

docker build -t nlmacamp/check_mk github.com/viper0131/check_mk --build-arg CMK_VERSION_ARG=1.5.0p2 --build-arg CMK_DOWNLOADNR_ARG=38

IMPORTANT - the container needs SYS_ADMIN capability

Start Check_MK using:

    docker run -itd --name check_mk \
           --publish 80:5000 \
           --cap-add=SYS_ADMIN \
           --restart always \
           nlmacamp/check_mk

OPTIONAL: Specify outgoing mail server with -e "MAILHUB=<IP:PORT>"

OPTIONAL: If you want to change the timezone in the docker container, use -e TZ=Europe/Berlin

OPTIONAL: If you want to change the password for administrative user 'cmkadmin', use -e CMK_PASSWORD=p4ssw0rd. This work only on first run of docker container. You can also change it on Wato (web GUI).

OPTIONAL: If you want to change the name of your site (default: mva), use -e CMK_SITE=mysite.

You should map site directory (configuration, graphs, custom checks):

--volume <localdir>:/opt/omd/sites/<CMK_SITE>

If you want to map a local directory (e.g. for backup or check scripts):

  --volume <localdir>:/opt/backup

Check the status of check_mk using:

docker exec -it check_mk omd status

the result should look like:

Doing 'status' on site mva:
mkeventd:       running
rrdcached:      running
npcd:           running
nagios:         running
apache:         running
-----------------------
Overall state:  running

Fireup the Check_MK GUI:

Browse to http://localhost/mva

login with the default user cmkadmin with password omd (or the pesonalized one, if specified in Quickstart).

1. Get your container name (docker ps).
2. Get your desired check_mk version and his downloadnr as described in Use another version
3. Run this command (with correct container name and cmk version and downloadnr): docker exec -it <container> /opt/update.sh <CMK_VERSION_ARG> <CMK_DOWNLOADNR_ARG> (Ex. docker exec -it check_mk /opt/update.sh 1.5.0p2 38)