Quick start

Deze gids loodst je in vijf minuten van een leeg account naar je eerste metrics. Je hebt een Linux-server nodig met root-toegang. Windows volgt.

1. Maak een account

Open https://monsys.ai/signup, vul bedrijf, e-mail en wachtwoord in. Je wordt direct doorgestuurd naar de hub.

2. Genereer een agent-token

In het dashboard: Instellingen → Agents. Geef de server een naam (bv. web-edge-01) en klik Generate token →. Je krijgt direct het volledige token — kopieer het meteen, we tonen het maar één keer.

Opgepast

Het token in de install-snippets in deze docs is een placeholder. Het echte token uit het dashboard is een 64-tekens hex string en moet volledig in het commando blijven staan, niet de afgekorte voorbeeld-versie.

3. Installeer de agent

Plak het commando dat het dashboard je gaf op je server (als root):

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

Of expliciet:

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

De installer:

1. Download de Rust-binary (~5 MB) naar /usr/local/bin/monsys-agent
2. Schrijft /etc/monsys/agent.toml met je token (mode 0640)
3. Plant honeypot-canaries
4. Installeert de scope-locked sudoers regels
5. Activeert monsys-agent.service onder systemd

4. Verifieer

systemctl status monsys-agent
journalctl -u monsys-agent -f

Verwachte output:

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

Open daarna in het dashboard Servers — binnen ~30 seconden zie je je host als online met live CPU/RAM/disk/network grafieken.

5. Vul de metadata in

Klik je nieuwe server open en gebruik ⚙ Metadata rechtsbovenaan om cloud provider, regio, group, role en tags toe te voegen. IP’s en hostname zijn al automatisch ingevuld.

Volgende stappen

• Verbind webhooks of ntfy push
• Bekijk de REST API reference
• Lees over het Emergency Action Protocol