Quick Start

At the center of Monika is a configuration file. Follow the steps below to quickly setup monitoring and get notification when a website is down via Desktop notifications.

Installation

There are two ways to install Monika

1. Install using npm or yarn.

   If you're using NPM or Yarn, you can simply run this command in your terminal:

   1 $ npm i -g @hyperjumptech/monika
   2 # or
   3 $ yarn global add @hyperjumptech/monika

2. Download and run standalone binary

   Head over to Monika Release page, download the Monika file according to your operating system, and rename it to monika.

   UNIX-based users may have to run sudo chmod +x monika in order to execute Monika binary file. Please note that currently, only x64 architecture is supported.

   In order to run Monika binary file, you must download the node_sqlite3-<os>-<arch>.node file according to your OS, rename it to node_sqlite3.node and put it in one folder with the Monika binary file.

Download the configuration file

Download the example configuration that uses Desktop notification here and rename it as monika.yml

Run Monika

Monika by default reads a yaml configuration file called monika.yml in the current working directory if it exists. To run monika with the configuration file that you have downloaded before, run this command in the Terminal from the directory that contains the monika.yml file:

 monika

You can specify a path to a YAML configuration file with -c flag if you didn't rename your configuration file as monika.yml, as follows

 monika -c <path_to_configuration_file>

Better yet, you can provide a URL that contains monika configuration

 monika -c https://domain.com/path/to/your/configuration.yml

Congratulations, you have successfully run Monika in your machine!

Next Step

For advanced configuration such as configuring notifications, probes, and alerts, you can find them on the sidebar menu.