Dockerized M/Monit by Apptie Software

Summary

M/Monit is a web UI and aggregation utility meant to be used together with Monit

• Monit website
• Our Dockerized Monit

Important

Pay attention to environment variables. It's easy to confuse MMONIT... (for M/Monit) and MONIT... (for Monit)

Usage

docker

docker create \
  --name=mmonit \
  -e MMONIT_PORT=8080 \
  -e MMONIT_DOMAIN= \
  -e MMONIT_URL="https://${MMONIT_DOMAIN}" \
  -e MMONIT_VERSION="4.3.4" \
  -e MMONIT_DATABASE_URL= \
  -e MMONIT_LICENSE_OWNER="you" \
  -e MMONIT_LICENSE_KEY="yours" \
  -e MONIT_USER="admin" \
  -e MONIT_PASS="changeme" \
  -e TZ=Europe/Kyiv \
  --expose 8080 \
  -v </path/to/conf>:/opt/mmonit-${MMONIT_VERSION}/conf \
  --restart unless-stopped \
  Apptie-Software/mmonit

docker-compose

services:
  mmonit:
    image: Apptie-Software/mmonit
    container_name: mmonit
    environment:
      MMONIT_PORT: 8080
      MMONIT_DOMAIN:
      MMONIT_URL: "https://${MMONIT_DOMAIN}"
      MMONIT_VERSION: "4.3.4"
      MMONIT_DATABASE_URL:
      MMONIT_LICENSE_OWNER: "you"
      MMONIT_LICENSE_KEY: "yours"
      TZ: Europe/Kyiv
      MONIT_USER: "admin"
      MONIT_PASS: "changeme"
    volumes:
      - </path/to/conf>:/opt/mmonit-${MMONIT_VERSION}/conf
    expose:
      - 8080
    restart: unless-stopped

Parameters

Port

You can set a custom port with MONIT_PORT

Note

Don't forget to put it in --expose or expose:

Environment Variables (-e or environment:)

Variable	Function
MMONIT_PORT=8080	8080 is the default port, you can set your own.
MMONIT_DOMAIN=	domain/subdomain path of M/Monit
MMONIT_URL=	full url on which M/Monit would be reached (constructed from MMONIT_DOMAIN)
MMONIT_VERSION=4.3.4	4.3.4 is the latest version at the moment of writing, you can set your own.
MMONIT_DATABASE_URL=	full url for a database connection other than SQLite
MMONIT_LICENSE_OWNER=	M/Monit license owner
MMONIT_LICENSE_KEY=	M/Monit license key
TZ=UTC	Specify a timezone to use EG UTC
MONIT_USER	Username for logging into M/Monit
MONIT_PASS	Password for logging into M/Monit

Volume Mappings (-v)

Volume	Function
/opt/mmonit-{version}/conf	All the config files reside here

Setup

If your M/Monit is behind a proxy, you'd need to configure the <Engine> and <Connector> options further, i.e.:

<Connector address="*" port="8080" processors="10" proxyScheme="https" proxyName="subdomain.domain.xyz" proxyPort="443" />

<Engine name="mmonit" defaultHost="subdomain.domain.xyz" fileCache="10MB">

<!-- ... -->

</Engine>

Note

The proxyName attribute in the <Connector> and the defaultHost attribute in the <Engine> have to be the same.

TODO

• search for the latest M/Monit version on the dist