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:

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

# Download (use agent_arm64 for ARM systems)
wget $URL/arctic/v1.3.0/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, creates the data directory, and starts the agent automatically.

Troubleshooting

If the agent fails to start, check the logs:

journalctl -u arctic-agent -f

Common causes: missing dependencies, port 8080 in use, 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:

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

# For x86_64
wget $URL/arctic/v1.3.0/arctic_linux_amd64
chmod +x ./arctic_linux_amd64
sudo mv ./arctic_linux_amd64 /usr/local/bin/arctic

# For ARM64
wget $URL/arctic/v1.3.0/arctic_linux_arm64
chmod +x ./arctic_linux_arm64
sudo mv ./arctic_linux_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

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/v1.3.0/checksums.txt
wget $URL/arctic/v1.3.0/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.