Server CLI

Server-side CLI for
recipe execution.

A lightweight Go binary installed on your servers that allows executing HostAtlas recipes directly from the terminal. Manage services, run automation scripts, and keep your infrastructure in check — all without leaving the command line. Auto-updates via the agent or a single manual command.

<5 MB

Binary size

0

Dependencies

TLS 1.3

Encryption

2

Architectures

Capabilities

Everything you need on the server.

The Server CLI brings HostAtlas recipe execution, service management, and secure API communication directly to your server terminal.

play_arrow

Recipe Execution

Run any HostAtlas recipe directly from the server terminal. Execute multi-step automation scripts that configure services, deploy updates, or enforce compliance policies — all defined and versioned in your HostAtlas dashboard.

restart_alt

Service Management

Start, stop, and restart services with built-in safeguards. The CLI validates service names against the HostAtlas whitelist and reports the result back to the platform, ensuring every action is tracked and auditable.

system_update_alt

Auto-Update

The Server CLI self-updates automatically via the HostAtlas agent or through a manual update command. New versions are downloaded from Cloudflare R2, verified, and swapped in place without service interruption.

fitness_center

Lightweight

A single statically-compiled Go binary under 5 MB with zero external dependencies. No runtime, no package manager, no library conflicts. Just copy the binary and run it. Works on any Linux distribution.

lock

Secure

All communication with the HostAtlas API is encrypted over TLS 1.3. Requests are authenticated with HMAC-SHA256 signatures and scoped to the server's identity. No inbound ports required — outbound only.

devices

Multi-Platform

Supports Linux amd64 and arm64 architectures. Run the Server CLI on traditional x86 servers, AWS Graviton instances, Raspberry Pi, or any ARM-based infrastructure. One tool across your entire fleet.

Installation

Installed automatically. Ready instantly.

The Server CLI is installed automatically when you deploy the HostAtlas agent. It can also be installed manually with a single curl command. The installer detects your architecture, downloads the correct binary, and places it in your PATH.

01

Via Agent (automatic)

When you install the HostAtlas agent, the Server CLI is included and configured automatically. The agent keeps it updated alongside itself.

02

Via curl (manual)

Download the binary directly with a single curl command. The installer detects amd64 or arm64 and places the binary in /usr/local/bin.

terminal Install via agent
# Installed automatically with the agent
curl -sSL https://install.hostatlas.app/install.sh | sudo bash -s -- --key=YOUR_SERVER_KEY

# The Server CLI is now available
hostatlas-cli --version
terminal Run a recipe
# Execute a recipe by name
hostatlas-cli recipe run update-packages

# Manage services
hostatlas-cli service restart nginx
hostatlas-cli service status mysql

# Self-update
hostatlas-cli update

Get started

Install the agent. The Server CLI comes included.

One command installs everything — the agent, the Server CLI, and full connectivity to the HostAtlas platform. Run recipes, manage services, and automate your infrastructure from the terminal within seconds.

curl -sSL https://install.hostatlas.app/install.sh | sudo bash -s -- --key=YOUR_SERVER_KEY
download <5 MB binary lock TLS 1.3 encrypted devices Linux amd64 & arm64