Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
67 lines (54 sloc) 3.19 KB

Amon On-Premise Installation

This document describes the steps I go through during the installation of amon on-premise.

For some reason, I have to install a on-premise amon server for the team. The documenation from amon is good but due to a development conflict/bug, here is the solution.

Amon On-Premise Monitoring Server

Amon is a Django application, which stores all performance data in a MongoDB database. It is open source and you can find the code here.

Hardware Requirement

  • 2GB of RAM, 4GB or More if you plan to monitor more then 20 machines
  • 50GB - On average storing data for 1 server with the default 30 days retention takes around 500MB of disk space
  • A dedicated (sub) domain if it is for public access
  • Ubuntu 16.04 LTE (suggested)

Setup Amon Server

  1. Install git. #sudo apt-get install git
  2. Download the easy setup scripts from Go to /opt/ and use the command #git clone
  3. Go to the amon-server folder and edit the Change the email address in Line 7.
  4. Edit the and replace the line 37 by
# Install old working commit
cd /opt/amon && . /opt/amon/env/bin/activate && \
git checkout 773fdca && \
pip install -r /opt/amon/requirements.txt && \
python migrate

# Fix CSRF error (if you have it)
echo >> /opt/amon/amon/
echo 'CSRF_TRUSTED_ORIGINS = [host_struct.hostname,]' >> /opt/amon/amon/

# Update to master
cd /opt/amon && . /opt/amon/env/bin/activate && \
git checkout master && \
pip install -r /opt/amon/requirements.txt && \
python migrate && \
systemctl restart amon.service

*code from

  1. Assume for private use, run the #./ private
  2. If everything goes well, you should have amon, postfix, mongo and nginx installed and running.
  3. Edit the /opt/amon/amon/ and the ALLOWED_HOST on line 214 and restart the nignx
  4. Edit the /opt/amon/amon/ to the following and restart the postfix. EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
  5. Open a browser and go to the server ip address. You will see a create admin account screen.
  6. Create an account and try to login.
  7. Go to Setting > SMTP and try to send a testing email.

Setup Amon Agent

Please consult for more detail.

  • I cannot install via the installation url, so I manual install.
  1. Make sure you have python 2.7 installed in your monitor PC.
  2. Obtain the API Key from the server from amon admin page.
  3. Follow the manual installation steps and replace the API key and the server IP.
  4. If success, you will see the agent is running and you can find it in the amon server.

Public Amon

If you are installing Amon for public, replace the public to private on step 5. #./ private I have problem getting the SSL certificate due to the IP and domain are not mapped. Please make sure the IP and domain are mapped before the installation start.


Big thanks to bigcalm for providing the installation scripts.

You can’t perform that action at this time.