Agent Installation

The SecureCheap Agent is a lightweight daemon (~4 MB) that runs on your server and streams real-time metrics to your dashboard.

The agent is optional. Without it, SecureCheap still monitors uptime, SSL, DNS, and runs security scans via remote checks. Install it when you need CPU / RAM / disk / process metrics from inside the server.

Requirements

	Minimum
OS	Ubuntu 20.04+, Debian 11+, CentOS 8+, AlmaLinux 8+, Rocky 8+
CPU	1 vCPU
RAM	512 MB
Disk	50 MB free
Outbound	HTTPS (443) to `agent.securecheap.com`

One-line install

Copy your server token from Dashboard → Resources → Add Server → Copy Token, then run:

curl -sSL https://securecheap.com/install.sh | sudo bash -s -- --token YOUR_SERVER_TOKEN

The script:

Detects your distro and downloads the correct binary
Creates a securecheap system user
Installs a systemd service (securecheap-agent)
Starts the agent and registers it with the platform

Manual install

# Download
curl -LO https://releases.securecheap.com/agent/latest/securecheap-agent_linux_amd64.deb
 
# Install
sudo dpkg -i securecheap-agent_linux_amd64.deb
 
# Configure
echo "token: YOUR_SERVER_TOKEN" | sudo tee /etc/securecheap/agent.yml
 
# Start
sudo systemctl enable --now securecheap-agent

Verify installation

sudo systemctl status securecheap-agent
# Expected: active (running)
 
# View agent logs
sudo journalctl -u securecheap-agent -f

Within 30 seconds of starting the agent, your server appears as Online in the Resources dashboard with live metric graphs.

Agent configuration reference

/etc/securecheap/agent.yml

# Required
token: YOUR_SERVER_TOKEN
 
# Optional overrides
report_interval: 15          # Seconds between metric pushes (default: 15)
collect_processes: true      # Send top-20 process list (default: true)
collect_network: true        # Per-interface traffic (default: true)
collect_disk: true           # Per-mount disk usage (default: true)
log_level: info              # debug | info | warn | error
 
# Custom labels (appear in the dashboard)
labels:
  env: production
  region: eu-west-1
  role: web

Uninstall

sudo systemctl stop securecheap-agent
sudo apt remove securecheap-agent   # or: rpm -e securecheap-agent
sudo rm -rf /etc/securecheap

Quick Start Authentication