Manual Installation


To get Moira running quickly, try Docker version

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

  1. golang version 1.9 or higher
  2. redis database version 3.2 or higher
  3. web server e.g. nginx

Build Moira Microservices

go get -u
cd $GOPATH/src/
make build

You will find binaries in $GOPATH/src/

Download Web UI Application

Download and unpack .tar.gz file into Nginx static files directory (e.g. /var/local/www/moira).


  1. If you need to override default settings, place configuration files somewhere on your disk (e.g. /etc/moira/). You can dive into Configuration syntax on a separate page.
  2. Place nginx configuration file to proper location (e.g. /etc/nginx/conf.d/moira.conf):
server {
    location / {
        root /var/local/www/moira;
        index index.html;
        try_files $uri $uri/ /index.html;
    location /api/ {

3. If you need to override UI settings, edit web.json file. You can find its location in API configuration.


  1. Run nginx and redis-server
  2. Run microservices

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).