Install the Frabs Agent

The Frabs agent runs as a systemd service on Ubuntu and Debian. Installation takes under a minute.

Requirements

  • • Ubuntu 20.04, 22.04, or 24.04
  • • Debian 11 or 12
  • • sudo or root access
  • • Outbound HTTPS access to frabs.net
  • • An active Frabs subscription with an available server licence

Step 1: Add a server in Console

Open the Frabs Console, go to Servers, and click Add Server. Give it a name and choose the environment. The console will generate a unique install command with your token.

Step 2: Run the install command

$ curl -fsSL https://frabs.net/install.sh | sudo bash -s -- --token YOUR_TOKEN_HERE

The install token expires after 30 minutes. Generate a new one from the server page if needed.

What the installer does

  1. Checks OS compatibility
  2. Creates the frabs-agent system user
  3. Creates directories: /etc/frabs-agent/, /var/lib/frabs-agent/, /var/log/frabs-agent/
  4. Downloads and installs the agent binary
  5. Writes config to /etc/frabs-agent/config.toml
  6. Installs and starts frabs-agent.service
  7. Registers the server with Frabs API

Verify the installation

$ sudo systemctl status frabs-agent
$ sudo journalctl -u frabs-agent -f

Useful commands

Restart agent
sudo systemctl restart frabs-agent
Stop agent
sudo systemctl stop frabs-agent
View agent logs
sudo journalctl -u frabs-agent -f
Agent config
sudo cat /etc/frabs-agent/config.toml

Config file location

Config: /etc/frabs-agent/config.toml
State: /var/lib/frabs-agent/state.json
Logs: /var/log/frabs-agent/agent.log