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

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

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

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

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

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