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.
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.
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.
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.
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.
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.
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.
Via Agent (automatic)
When you install the HostAtlas agent, the Server CLI is included and configured automatically. The agent keeps it updated alongside itself.
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.
# 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 # 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