lgustafson / docker-monit

Docker image for monit

A minimal base image for monit

docker-monit is a Docker image that is configured to be used directly or as a base for more customized applications for monit, the monitoring daemon. docker-monit is available for pulling from the Docker registry

This image includes monit version 5.13

Overview

This image installs monit to the following location:

• /opt/monit

Monit is configured to be executed and managed by the runit, the init system of phusion/baseimage-docker. It will be executed as a non-privileged user named monit. The monit configuration file lives at:

• /home/monit/conf/monitrc.

The supplied monitrc simply includes all .conf files at the following locations:

• /home/monit/conf/monitrc.d
• /home/monit/conf/monit.d

Monit Configuration

By default, monit is configured as follows:

• HTTP console running on port 2812
  • Username "admin" with password "monit" for admin access
  • Users who are part of the monit group have admin access
  • Users who are part of the users group have readonly access
• Monit cycle is set to 60 seconds

Config files in /home/monit/conf/monitrc.d typically should define the basic runtime configuration of monit itself, while config files in /home/monit/conf/monit.d should be service checks. This allows a user to use the basic runtime configuration supplied by monit and add monit checks by mounting a directory of config files (from the host, for instance) at /home/monit/conf/monit.d.

Along the same lines, the runtime configuration can be completely replaced by mounting a configuration directory to /home/monit/conf/monitrc.d.

Docker Configuration

Exposed Ports:

• 2812 (Monit httpd)

Dependencies

• phusion/baseimage-docker

Examples

# Runs a container that will be deleted at shutdown with the following
# properties:
#   * exposes container port 2812 to the host
#   * injects monit check configurations from the host at /tmp/monit.d
docker run --rm --name "test-docker-monit" -p 2812:2812 -v /tmp/monit.d/:/home/monit/conf/monit.d lgustafson/docker-monit:latest