nlmacamp/check_mk:1.5.0p21
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
- Get your container name (
docker ps
). - Get your desired check_mk version and his downloadnr as described in Use another version
- 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
)