Getting started

By default Check_MK server is installed from the check-mk-raw Debian package as provided by Mathias Kettner upstream. It includes the omd tool which is used for managing the monitoring sites. The role will create a default site called 'debops'. After the setup it can be reached by accessing https://<fqdn>/check_mk/debops.

Example inventory

You can install Check_MK server on a host by adding it to the [debops_service_checkmk_server] host group in your Ansible inventory:


Example playbook

Here's an example playbook that uses the debops-contrib.checkmk_server role to install Check_MK server:


- name: Manage Check_MK server
  hosts: [ 'debops_service_checkmk_server' ]
  become: True


    - role: debops.etc_services
      tags: [ 'role::etc_services' ]
        - '{{ checkmk_server__etc_services__dependent_list }}'
      when: checkmk_server__multisite_livestatus|d()

    - role: debops.ferm
      tags: [ 'role::ferm' ]
        - '{{ checkmk_server__ferm_dependent_rules }}'

    - role: debops-contrib.checkmk_server
      tags: [ 'role::checkmk_server' ]

The inclusion of the debops.ferm is optional. This playbooks is shipped with this role under docs/playbooks/checkmk_server.yml from which you can symlink it to your playbook directory.

Ansible tags

You can use Ansible --tags or --skip-tags parameters to limit what tasks are performed during Ansible run. This can be used after a host was first configured to speed up playbook execution, when you are sure that most of the configuration is already in the desired state.

Available role tags:

Main role tag, should be used in the playbook to execute all of the role tasks as well as role dependencies.
Execute tasks which are generating the monitoring rules definitions.
Execute tasks which configure the Check_MK multisite Web interface.
Execute tasks to install Check_MK packages.