Skip to content
monsys.ai

Quick start

This guide will lead you from an empty account to your first metrics in five minutes. You need a Linux server with root access. Windows follows.

1. Create an account

Section titled “1. Create an account”

Open https://monsys.ai/signup, fill in company, email and password. You will be directly forwarded to the hub.

2. Generate an agent token

Section titled “2. Generate an agent token”

In the dashboard: Settings → Agents. Give your server a name (e.g. web-edge-01) and click Generate token →. You will immediately receive the full token — copy it right away, we only show it once.

3. Install the agent

Section titled “3. Install the agent”

Paste the command that the dashboard gave you on your server (as root):

Terminal window
curl -fsSL https://get.monsys.ai/install.sh | sudo MONSYS_TOKEN=<your-token> bash

Or explicitly:

Terminal window
curl -fsSL https://get.monsys.ai/install.sh -o /tmp/monsys-install.sh
sudo MONSYS_TOKEN="<your-token>" bash /tmp/monsys-install.sh

The installer:

  1. Downloads the Rust binary (~5 MB) to /usr/local/bin/monsys-agent
  2. Writes /etc/monsys/agent.toml with your token (mode 0640)
  3. Plants honeypot-canaries
  4. Installs scope-locked sudoers rules
  5. Enables monsys-agent.service under systemd

4. Verify

Section titled “4. Verify”
Terminal window
systemctl status monsys-agent
journalctl -u monsys-agent -f

Expected output:

● monsys-agent.service - Monsys System Monitoring Agent
     Active: active (running) since 09:21 UTC

Open the dashboard Servers — within ~30 seconds you will see your host as online with live CPU/RAM/disk/network graphs.

5. Fill in metadata

Section titled “5. Fill in metadata”

Click on your new server and use ⚙ Metadata top-right to add cloud provider, region, group, role and tags. IP’s and hostname are already automatically filled in.

Next steps

Section titled “Next steps”