Installation

Install the Citadel CLI on your platform of choice. The binary is self-contained with no external dependencies required for basic operation.

Install Citadel

Linux / macOS

One-liner (recommended)

curl -fsSL https://get.aceteam.ai/citadel.sh | bash

This downloads the latest release, places the binary in your PATH, and verifies the checksum.

Homebrew (macOS)

brew install aceteam-ai/tap/citadel

Windows

Open PowerShell as Administrator and run:

iwr -useb https://raw.githubusercontent.com/aceteam-ai/citadel-cli/main/install.ps1 | iex

The installer places citadel.exe in %LOCALAPPDATA%\Citadel and adds it to your PATH.

Go Install

If you have Go 1.21+ installed:

go install github.com/aceteam-ai/citadel-cli/cmd/citadel@latest

The binary is placed in your $GOPATH/bin directory.

From Source

Clone the repository and build:

git clone https://github.com/aceteam-ai/citadel-cli.git
cd citadel-cli

Linux / macOS

./build.sh

The binary is created in ./build/.

Windows

.\build.ps1

Verify the installation

citadel version

You should see output showing the installed version, for example:

citadel version v2.3.0

System requirements

Requirement	Details
Operating system	Linux (amd64/arm64), macOS (amd64/arm64), or Windows 10+ (amd64)
Docker	Required for running AI services. Installed automatically by citadel init --provision.
GPU	Optional but recommended. NVIDIA GPUs supported on Linux and Windows (via WSL2). Apple Silicon supported on macOS via Metal.
Network	Outbound HTTPS access to aceteam.ai and nexus.aceteam.ai
VPN client	None. The AceTeam Network client is built into the citadel binary — there is no separate app, daemon, or driver to install, and no admin rights are needed to join.

Next steps

Once installed, head to the Quick Start to connect your node to the AceTeam Network.