Getting Started

The Munara agent runs on a PC or Raspberry Pi at your site. It monitors your local network devices and connects securely to this console so you can view status, receive alerts, and access the agent remotely from anywhere.

🖥

Ready to go

Want a plug-and-play option?

We supply a compact mini PC with the Munara agent pre-installed and pre-configured. Plug it in, connect it to the network, and skip straight to registration — no Linux setup required.

Get in touch →

Requirements

The agent runs on any Linux device with snapd. These are the minimum specifications.

Hardware (x86-64)

Any PC or mini-PC
2 GB RAM · 8 GB storage
Intel / AMD processor

Hardware (ARM)

Raspberry Pi 4 or 5
2 GB RAM · 16 GB microSD
ARM64 (64-bit OS required)

Operating system

Ubuntu 22.04 LTS or later
Debian 12 (with snapd)
Any snapd-supported Linux

Network

Outbound internet access
Port 8883 (MQTTS) to this cloud
Local network access to monitored devices

ℹ Ubuntu Server is recommended — it includes snapd out of the box and has low resource overhead. A Raspberry Pi 4 (2 GB) running Ubuntu Server 24.04 LTS works well for most SMB deployments.

Assign a static IP address

The agent's local web interface is accessed by IP address, so it must not change.

The easiest approach is a DHCP reservation in your router — this pins a fixed IP to the device's MAC address without any OS configuration. Log in to your router's admin interface, find the DHCP reservation or static lease section, and assign a fixed address to this device.

ℹ Choose an IP outside your router's DHCP range to avoid conflicts — for example, if your router allocates 192.168.1.100–200, use something like 192.168.1.50.

Alternatively — set a static IP in the OS (Ubuntu / netplan)

Example: /etc/netplan/00-installer-config.yaml

network:
  ethernets:
    eth0:                          # replace with your interface name
      dhcp4: false
      addresses: [192.168.1.50/24]
      routes:
        - to: default
          via: 192.168.1.1
      nameservers:
        addresses: [8.8.8.8, 8.8.4.4]
  version: 2
          

# Apply the config
sudo netplan apply
          

ℹ Run ip link to find the correct interface name on your device — it may be eth0, enp3s0, ens18, or similar.

Install the agent

SSH into your device and run the following commands.

# snapd is pre-installed on Ubuntu — install the agent directly
sudo snap install munara-monitoring-agent
            

# Install snapd first (Debian example)
sudo apt update && sudo apt install -y snapd
sudo snap install core

# Then install the agent
sudo snap install munara-monitoring-agent
            

ℹ The snap is available for x86-64 and arm64. Snapd selects the right architecture automatically — no flags required. The agent is pre-configured to connect to this cloud; no additional setup is needed after installation.

ℹ You can verify the agent is running with sudo snap logs munara-monitoring-agent. Look for a line containing connected to MQTT broker.

Open the agent's local web interface and link it to your account.

From any browser on the same local network, navigate to the agent's IP address on port 8090. If you're using our pre-configured mini PC, start here — steps 1 and 2 are already done.

http://192.168.1.50:8090   # replace with your static IP
          

The agent's local dashboard will open. Click Register at Munara Cloud and sign in with your Munara account. This links the agent to your organisation — after which it appears in the Swarm Console and can be accessed remotely.

Agent local UI — example

Munara Agent

Not registered with cloud

↑ Click this button to link the agent to your account

✓ Once registered, the agent appears in the Swarm Console. You can then access it remotely via the secure cloud relay without being on the local network.

ℹ If the page doesn't load, check that the snap is running (sudo snap logs munara-monitoring-agent) and that you're on the same network as the device.

Start monitoring

Once the agent is registered, open its local UI to add devices and configure monitoring.

Click Open ↗ on the registered agent to access its local web interface through the secure cloud relay. From there you can:

Run Network Discovery

Scan the local network to find SNMP devices, cameras, and other monitorable hosts automatically.

Add Devices Manually

Add a device by IP address and select its monitoring protocol — SNMP, Ping, HTTP, ONVIF, or Alarm Panel.

Configure Alerts

Set up forwarding rules to send alerts by email or HTTP when a device goes down or triggers an alarm.

Add More Sites

Install an agent at each site you want to monitor. Each site appears in the console dashboard.

Go to console →