nlmacamp/check_mk repository overview

⁠nlmacamp/check_mk:1.5.0p21

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

⁠Introduction

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.

⁠Contributing

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

⁠Issues

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.

⁠Getting started

⁠Installation

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

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

Alternatively you can build the image yourself.

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

⁠Use another version

If you want to change the version of check_mk, use --build-arg CMK_VERSION_ARG=1.5.0p21 --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.0p21/check-mk-raw-1.5.0p12-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.0p21 --build-arg CMK_DOWNLOADNR_ARG=38

⁠Quickstart

IMPORTANT - the container needs SYS_ADMIN capability or privileged mode (depends on os / docker version)

Start Check_MK using:

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

If you get errors like

mount: tmpfs is write-protected, mounting read-only
mount: cannot mount tmpfs read-only

try start your container with --privileged instead of --cap-add=SYS_ADMIN

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

OPTIONAL: Specify outgoing mail server encryption with -e "MAILHUBSTARTTLS=YES"

OPTIONAL: Specify outgoing mail server login with -e "MAILHUBAUTHUSER=<USERNAME> and -e "MAILHUBAUTHPASS=<PASSWORD>"

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.

⁠Volumes

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

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

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

  --volume <localdir>:/opt/backup

⁠Test installation

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://<server-ip>

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

⁠Updates

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.0p21 38)