AutoHost logoAutoHost

Command Palette

Search for a command to run...

Agent

Agent Installation

Install the AutoHost Agent as a systemd service on your node.

The AutoHost Agent is a lightweight daemon that runs as a systemd service on each node. It sends heartbeats, collects system metrics, and executes remote commands dispatched from the cloud.

Requirements

  • Linux (Debian/Ubuntu-based, amd64 or arm64)
  • autohost CLI installed
  • Node enrolled with autohost up or autohost enroll link
  • sudo / root access

Installation

Use the CLI to download and install the agent binary, configuration template, and systemd unit file:

bash
autohost agent install
sudo systemctl enable autohost-agent
sudo systemctl start autohost-agent

The agent will begin sending heartbeats and system metrics to the cloud API every 15 seconds.

Verify

bash
# Check agent status
sudo systemctl status autohost-agent

# View agent logs
sudo journalctl -u autohost-agent -f

The AutoHost Agent is a lightweight daemon that runs on each node you want to manage. It handles container orchestration, health monitoring, and secure communication with the control plane.

Requirements

  • Linux server (Ubuntu 20.04+, Debian 11+, CentOS 8+)
  • Docker 20.10+ installed and running
  • Minimum 1GB RAM, 1 CPU core
  • Outbound HTTPS access to api.autohost.cloud

Installation

1

Download the agent

Use the installation script to download and install the agent:

bash
curl -fsSL https://get.autohost.cloud/agent | sudo sh
2

Get your node token

Generate a node registration token from the CLI or Cloud Panel:

bash
autohost nodes token create
3

Register the node

Connect the agent to your AutoHost account:

bash
sudo autohost-agent register --token <your-node-token>

Connecting to Cloud

Once registered, the agent will automatically connect to the control plane and appear in your Cloud Panel within seconds.

bash
# Check agent status
sudo systemctl status autohost-agent

# View agent logs
sudo journalctl -u autohost-agent -f