Public | Automated Build

Last pushed: 5 months ago
Short Description
A basic usable Xymon installation
Full Description

docker-xymon

Dockerization of the Xymon monitoring system on an Ubuntu base

Quick Start

docker run -d -p 80:80 -p 1984:1984 -v /etc/xymon:/etc/xymon -v /var/lib/xymon:/var/lib/xymon --name xymon deweysasser/xymon

or use docker-compose with

xymon:
  image: deweysasser/xymon
  ports:
    - 80:80
    - 1984:1984
  volumes:
    - xymon-config:/etc/xymon
    - xymon-data:/var/lib/xymon
  environment:
    SSMTP_mailhub: mail.example.com
    SSMTP_AuthUser: user
    SSMTP_AuthPass: password
    SSMTP_AuthMethod: LOGIN
    SSMTP_UseTLS: "Yes"

Interface

Ports

  • 80 -- Web server
  • 1984 -- Xymon/bb client reporting port

You only need to expose port 1984 if you are going to use a xymon
client
(e.g. native,
Windows or
docker).

Port 1984 should NOT be exposed to public (Internet facing) traffic.

Sending Mail

Any environment variables with the prefix SSMTP_ have the prefix
stripped and are otherwise copied verbatim into
/etc/ssmtp/ssmtp.conf.

You will need at least the environment variable SSMTP_mailhub and
will likely want:

  • SSMTP_mailhub
  • SSMTP_AuthUser
  • SSMTP_AuthPass
  • SSMTP_AuthMethod=LOGIN
  • SSMTP_UseTLS=Yes
  • SSMTP_STARTTLS=Yes

You can also choose to configure the file in other ways, for example
in a volume or by extending this docker image.

You may then configure Xymon
alerts
as
usual.

See the documentation for
SSMTP and Xymon
alerts
for
more details.

Volumes

  • /etc/xymon -- all xymon configuration data
  • /var/lib/xymon -- xymon data (monitoring state)

Timezone

By default the container will use the posixrules TZ rule set. If
you'd like to override this, set the environment variable 'TZ',
e.g. docker run -d -e TZ=America/New_York

Known Issues

  • Password protection on cgi directories is currently disabled

Maintainer

Please submit all issues/suggestions/bugs via
https://github.com/deweysasser/docker-xymon

Docker Pull Command
Owner
deweysasser
Source Repository

Comments (1)
hum3
a year ago

Thank you very much. I tried using zenoss and just failed. This I have got working usefully in minutes.

Have logged into my ubuntu docker using putty the first command is to get the image:
docker pull deweysasser/xymon' then:docker run -d -p 80:80 -p 1984:1984 -v /etc/xymon:/etc/xymon --name xymon deweysasser/xymonthen on the machinecd \etc\xymonThen edit the hosts.cfg file as required:sudo vi hosts.cfg`
It should all now be working.
ps on my Hyper-v hosted machine created by docker-machine I had to use CTRL-SCROLLOCK instead of ESCAPE to exit vi insert mode.