How to Install Checkmk Using Docker Compose: A Step-by-Step Guide

Checkmk is a powerful and flexible monitoring solution that supports monitoring of networks, servers, cloud services, containers, and applications. In this guide, we’ll walk through how to install Checkmk using Docker Compose — a quick and efficient way to get started with minimal setup.

Prerequisites

Before we begin, ensure you have the following installed on your Linux system:

• Docker
• curl

If Docker is not installed, follow the instructions on the Docker official site to install it first.

Step 1: Install Docker Compose

Start by installing Docker Compose, which is required to manage multi-container Docker applications.

version="v2.14.2"
curl -L https://github.com/docker/compose/releases/download/$version/docker-compose-linux-x86_64 -o /usr/local/bin/docker-compose \
&& chmod +x /usr/local/bin/docker-compose \
&& docker-compose --version

This command downloads and sets the correct permissions for Docker Compose.

Step 2: Set Up Directory Structure

Now create a directory to store Checkmk’s configuration and data.

mkdir -p /app/checkmk/data
cd /app/checkmk

Step 3: Create Docker Compose File

Next, create a docker-compose.yml file to define the Checkmk container:

cat << FLAG | tee docker-compose.yml
version: "3.6"
services:
  check-mk:
    image: checkmk/check-mk-free
    hostname: checkmk
    restart: unless-stopped
    volumes:
      - /etc/localtime:/etc/localtime
      - ./data:/omd/sites
    ports:
      - "5000:5000"
    ulimits:
      nproc: 65535
      nofile:
        soft: 20020
        hard: 40040
    environment:
      - CMK_LIVESTATUS_TCP=on
    tmpfs:
      - /opt/omd/sites/cmk/tmp:uid=1000,gid=1000
FLAG
docker-compose -f docker-compose.yml up -d

Step 4: Launch the Container

Run the container in detached mode:

docker-compose -f docker-compose.yml up -d

This starts Checkmk in the background.

Step 5: Retrieve the Admin Credentials

Once the container is up, check the logs to get the auto-generated admin password:

docker logs -f checkmk-check-mk-1

Look for output similar to this:

The admin user for the web applications is cmkadmin with password: jgOdDfYa

You can log in with this default user and change the password later if needed.

Step 6: Access the Web Interface

Open your browser and visit:

http://localhost:5000/cmk/check_mk/

Use the credentials provided in the logs:

Username: cmkadmin

Password: (Your retrieved password)

Optional: Manage from the Command Line

For advanced operations, you can switch to the site user via Docker exec:

docker exec -it checkmk-check-mk-1 su - cmk

You can then use commands like:

omd start
cmk-passwd cmkadmin

Conclusion

You now have Checkmk running in a Docker container using Docker Compose. This setup provides a flexible and fast way to deploy a monitoring solution without installing anything directly on your host OS. Stay tuned for more tutorials on configuring services and adding hosts to your Checkmk environment.

Top 10 VPN Services in 2025: Secure, Fast & Feature-Rich

Hướng dẫn cài đặt Cluster Kafka trên Ubuntu

https://forum.congdonglinux.com