Tillered Docs | Installation

This guide walks you through installing the Arctic agent on your Linux hosts and the Arctic CLI on your workstation.

Agent Installation

The Arctic agent runs on Linux hosts and manages network routing. Install it on each host that will participate in your cluster.

Download and Install

Download the appropriate binary for your architecture and run the install command:

# Download (use agent_arm64 for ARM systems)
wget https://release.tillered.com/arctic/latest/agent_amd64

# Install
chmod +x ./agent_amd64
sudo ./agent_amd64 install

# Verify
curl http://localhost:8080/livez

Expected response:

{"status":"ok","timestamp":"2026-01-15T10:30:00Z"}

The install command sets up the systemd service (unit name arctic), creates the data directory at /opt/tillered, and starts the agent automatically. This default unit runs the agent as root. To run it as an unprivileged user under a sandboxed unit instead, see Hardening (you manage the lifecycle by hand in that setup).

install and upgrade live on the agent binary

install and upgrade are subcommands of the downloaded agent binary (agent_amd64 / agent_arm64), not the arctic CLI. You will not find them in the CLI command reference. To upgrade an installed agent, download a newer agent binary and run sudo ./agent_amd64 upgrade.

Troubleshooting

If the agent fails to start, check the logs:

journalctl -u arctic -f

Common causes: port 8080 already in use, or the agent not running as root.

CLI Installation

The Arctic CLI is a command-line tool for managing Arctic clusters. Install it on your workstation or any machine where you want to manage Arctic.

Download the CLI

Download the appropriate binary for your operating system and architecture:

Platform	Binary
Linux (x86_64)	`arctic_linux_amd64`
Linux (ARM64)	`arctic_linux_arm64`
macOS (Apple Silicon)	`arctic_darwin_arm64`

# For x86_64
wget https://release.tillered.com/arctic/latest/arctic_linux_amd64
chmod +x ./arctic_linux_amd64
sudo mv ./arctic_linux_amd64 /usr/local/bin/arctic

# For ARM64
wget https://release.tillered.com/arctic/latest/arctic_linux_arm64
chmod +x ./arctic_linux_arm64
sudo mv ./arctic_linux_arm64 /usr/local/bin/arctic

# For Apple Silicon
wget https://release.tillered.com/arctic/latest/arctic_darwin_arm64
chmod +x ./arctic_darwin_arm64
sudo mv ./arctic_darwin_arm64 /usr/local/bin/arctic

Verify the CLI

Test that the CLI is installed correctly:

arctic version

You should see output showing the version, build date, and platform.

Enable Shell Completion (Optional)

Enable tab completion for commands and flags:

# Add to ~/.bashrc
echo 'source <(arctic completion bash)' >> ~/.bashrc
source ~/.bashrc

# Add to ~/.zshrc
echo 'source <(arctic completion zsh)' >> ~/.zshrc
source ~/.zshrc

arctic completion fish > ~/.config/fish/completions/arctic.fish

Binary Signature Verification (Optional)

Arctic binaries are signed with Ed25519 for integrity verification. This is recommended for production deployments.

# Set the download URL
URL=https://release.tillered.com

# Download verification files
wget $URL/arctic/latest/checksums.txt
wget $URL/arctic/latest/agent_amd64.sig
wget $URL/keys/release.pub

# Verify checksum
sha256sum -c checksums.txt --ignore-missing

# Verify signature
openssl pkeyutl -verify -pubin -inkey release.pub \
    -rawin -in agent_amd64 -sigfile agent_amd64.sig

Next Steps

Now that you have the agent and CLI installed, proceed to Quickstart to create your first cluster.

Installation

On this page