Manual Installation

There are following components you need to install before running Moira microservices:

  1. golang version 1.5 or higher
  2. redis database version 2.8 or higher
  3. python version 2.7
  4. web server e.g. nginx

Install Moira Microservices

Cache and Notifier

git clone
cd cache
sudo make
git clone
cd notifier
sudo make


git clone
cd worker
sudo make prepare
make pip
sudo pip install dist/moira_worker-*.tar.gz


  1. Place configuration file to the default location, /etc/moira/config.yml

You can dive into Configuration syntax on a separate page.

  1. Place nginx configuration file to /etc/nginx/conf.d/moira.conf
server {
    location / {
        root /var/local/www/moira;
        index index.html;
    location /api/ {
  1. Place UI config.json file to /var/local/www/moira/config.json


  1. Run nginx and redis-server
  2. Run cache
$GOPATH/bin/cache --config=/etc/moira/config.yml
  1. Run notifier
$GOPATH/bin/notifier --config=/etc/moira/config.yml
  1. Run API
  1. Run checker

Now you need to feed your metrics to Moira (see Feeding Metrics to Moira) on port 2003 and to create alerts in UI (see User Guide).