Quickstart

This is a quick-start guide that will get you running Alerta in under 5 minutes.

Install MongoDB

For Debian/Ubuntu, run:

$ sudo apt-get install -y mongodb-org
$ sudo mongod -f /etc/mongod.conf &

If apt-get can’t locate the “mongodb-org” metapackage package then follow these steps to add MongoDB package repository to apt sources list.

For other operating systems, see the installation steps on the MongoDB web site.

Install the Alerta Server

To install the alerta server:

$ pip3 install alerta-server
$ alertad run --port 8080

You should see something like:

* Running on http://127.0.0.1:8080/ (Press CTRL+C to quit)

Install the Web Console

To install the web console:

$ wget https://github.com/alerta/alerta-webui/releases/latest/download/alerta-webui.tar.gz
$ tar zxvf alerta-webui.tar.gz
$ cd dist
$ python3 -m http.server 8000

>> browse to http://localhost:8000

Install the Alerta CLI

To install the alerta command-line tool:

$ pip3 install alerta

Send some alerts

To send an alert to the server:

$ alerta send -r web01 -e NodeDown -E Production -S Website -s major -t "Web server is down." -v ERROR

The alert should appear almost immediately in the console. If it doesn’t it’s either a CORS issues or a bug.

What’s next?

Take the step-by-step tutorials or dive straight into a deployment.