Documentation

Everything you need,
from first run to fleet.

Focused guides for every stage. If something is still unclear, write to us — docs bugs are bugs.

Getting started

Install Linux server, macOS, native Windows — and how downloads are verified. Quickstart First run, password, launching your first agent session from a phone. Configuration config.json, environment variables, ports, projects root, engines. Docker sandbox Choose Local or an isolated Codex worker from Web, Desktop or mobile. Windows CLI Start the embedded server from PowerShell with explicit project, bind and data paths.

Operations

Updates & channels aircode update, stable/beta, rollback, why sessions survive updates. Remote access Tailscale/VPN (recommended), exposing safely, phones and the desktop app. Usage accounting How input, cached, output, reasoning, cost and per-question totals are counted. Troubleshooting Doctor commands, logs, common failure modes and their fixes.

Stuck? Ask the doctor first.

Install integrity, browser stack, token pipeline — the doctor commands pinpoint what's wrong before you have to guess.

$ aircode doctor packaging