Forge Home


Install and configure monit


9,439 latest version

1.6 quality score

Version information

  • 0.1.1 (latest)
  • 0.1.0
released Aug 24th 2014

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'tompurl-monit', '0.1.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add tompurl-monit
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install tompurl-monit --version 0.1.1

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.



tompurl/monit — version 0.1.1 Aug 24th 2014

Monit Puppet Module

Very simple module for installing and configuring monit.

Quick Start

Download the module and put it in your "modules" folder:

$ git clone

Add this to your manifest:

class { 'monit': 
  alert_address  => "",
  smtp_host      => "",
  smtp_port      => 587,
  smtp_user_name => "",
  smtp_password  => "thisIsReallyClever",

Visit the page with a console-based web browser (like elinks) from the local server console:

$ elinks http://localhost:2812
# username => admin, pass => monit    

You can change the username and password by setting the following parameters:

  • web_username
  • web_password


This is a very simple module that simply installs monit with a lightweight config file. Any additional configuration information should be placed in files that are stored in one of the following directories:

  • /etc/monit/conf.d
  • /etc/monit/monitrc.d #Seems to be preferred on Debian

Why Do I Need An Email Address?

The main way that monit communicates with you is by email. I recommend mandrill as a good, simple SMTP service.

Tested Platforms

Debian 7 on x64 and Raspbian. No effort has yet been made to make it work with anything else.

monit class parameters

Parameter Type Default Description
alert_address string none The address to which monit will send notifications
smtp_host string none The host names for your SMTP server
smtp_port int none Duh :)
smtp_user_name string none The username for your SMTP account
smtp_password string none The password associated with the $smtp_user_name value
web_username string admin The username that you want to use to log into monitweb
web_password string monit The password that you want to use with monitweb