Quick install

This page gets a complete Mugnsoft running on one Windows host: a Webserver, a probe (Monitor) and an Integrator. Allow about ten minutes.

Before you start

A 64-bit Windows host and an elevated PowerShell (right-click → Run as administrator).
Two license files named license_MNS.dat: one for the Webserver, one for the Integrator.
Ports 9090 (web UI) and 8050 (API) free on the host.

Another platform?

This page is the short path. For Linux, Docker, several hosts, or the manual steps, use Install on Linux, Install on Docker and Install on Windows.

Step 1: install the Webserver

Download the install script, put the Webserver’s license_MNS.dat next to it, and run it:


Invoke-WebRequest https://doc.mugnsoft.com/materials/mugnsoft-install.ps1 -OutFile mugnsoft-install.ps1 -UseBasicParsing
powershell -ExecutionPolicy Bypass -File .\mugnsoft-install.ps1 webserver -License .\license_MNS.dat

The script downloads the package, checks its signature, installs the Windows service and starts it. Keep the end of its output: it prints the _sharedInternal value that every other component needs.

Step 2: log in

Browse to https://localhost:9090/ and log in as admin / admin.
Choose a new admin password when asked. The Welcome to Mugnsoft window opens.

From here, choose one of the two paths below.

Starting from scratch: follow the guided tour

This is the recommended path. The tour builds the rest of the setup with you, one step at a time.

Pick your language at the top of the welcome window (English, Français or Español). The choice is saved on your user, see Your profile.
Click LET’S GO — GUIDE ME THROUGH IT.

A progress banner stays at the bottom of the page. Each step says what to do, Show me → points at the right place, and Back returns to the previous step.

Step	What you do
1. Webserver installed & running	Nothing: it is done once you are logged in.
2. Configure SMTP	Fill in the mail server in the Webserver settings, turn on the switch of the SMTP tile, then Save. With the switch off, no email is sent.
3. Add an Integrator	The robot button opens the config builder. Answer its questions and download `integrator.json`. Put it next to the `integrator` binary and run `integrator.exe install`. The tour then has you start and enable it.
4. Add a Probe	The same way, with `monitor.json`. The probe reports through the Webserver’s Integrator unless you pick another one.
5. Add a Sentinel Agent	Install it on a host you want to watch. It gets an application of its own, with ping, TCP, URL and API monitors that run on your probe.
6. See it work	The tour shows the monitors, then the application and its health, then the 3D view.

The tour remembers where you are in this browser, so you can stop and come back. Skip — I’ll explore on my own closes it. To start it again, use the Guided Tour button on the Applications page: it is shown to admins while no application exists yet.

Without the tour: two more commands

Prefer the command line? In the same elevated PowerShell, install the probe and the Integrator with the _sharedInternal value printed in step 1. Replace <host address> with the IP or DNS name of this host, and put the Integrator’s license_MNS.dat next to the script first.


# probe (Monitor)
powershell -ExecutionPolicy Bypass -File .\mugnsoft-install.ps1 monitor -Webserver <host address>:8050 -SharedInternal <value from step 1> -Location Paris

# Integrator
powershell -ExecutionPolicy Bypass -File .\mugnsoft-install.ps1 integrator -Webserver <host address>:8050 -SharedInternal <value from step 1> -License .\license_MNS.dat

Each component registers itself with the Webserver. Then, in the web UI:

Open gear menu → components. The probe and the Integrator are in the topology.

Component topology after the components registered

A newly registered component may be disabled (grey): right-click it and choose enable server.
Right-click it again and choose health check to confirm that the Webserver reaches it.