H

Quick Start

Get your first server connected in under 30 seconds.

Prerequisites

  • A HelmRelay account (free)
  • A Linux VPS with root or sudo access
  • Outbound HTTPS (port 443) access

Step 1 — Get your connection token

After signing in, go to your Dashboard → Servers → Add Server. You'll see a connection token. Copy it — you'll need it during installation.

Step 2 — Install the agent

SSH into your server and run the install command from your dashboard. It includes your token and server ID automatically:

Install command
$ curl -sSL https://cdn.helmrelay.com/install.sh | sudo bash -s -- --token YOUR_TOKEN --server-id YOUR_SERVER_ID

The installer downloads the agent binary, creates a systemd service, writes the config, and starts monitoring immediately.

Step 3 — Verify connection

Check that the agent is running:

sudo systemctl status helmrelay-agent

You should see active (running). Your server will also appear in the dashboard within a few seconds.

Step 4 — Start managing

Go to your Dashboard → Command Center, select your server, and try:

  • Show system info — displays OS, uptime, CPU, memory
  • Check disk usage — runs df -h formatted output
  • List running services — shows active systemd services

Next steps