aircodezero/aircode repository overview

⁠AirCode Ø server

Drive Claude Code, Codex, Grok Build and Kimi Code from any device. This image runs the AirCode Ø server on a machine or VPS you control. It installs the same signed Linux package as the official installer, with Node.js, the web client and those four agent CLIs included.

• Website: https://aircodezero.com⁠
• Install guide: https://aircodezero.com/docs/install#docker⁠
• Platforms: linux/amd64, linux/arm64

⁠Start it

docker run -d --name aircode --restart unless-stopped --stop-timeout 30 \
  -p 7860:7860 -v aircode-home:/home/aircode aircodezero/aircode:stable

Or with Docker Compose, in a directory of its own:

curl -fsSLO https://aircodezero.com/docker/compose.yaml
docker compose up -d

Open http://<server-address>:7860 and sign in with the password the container prints once in its logs on first start:

docker logs aircode

To choose the password instead, set AIRCODE_AUTH_PASSWORD when you create the container. An empty value is ignored, so authentication always stays on.

⁠Private HTTPS address

That first visit uses plain HTTP. In AirCode Ø, open Settings → Remote access and sign in to your AirCode Ø account: the server then gets its private address, such as https://<name>.tunnel.aircodezero.com. The connection is outbound only, so there is no port to open.

⁠Tags

⁠Data and updates

Projects, provider sign-ins, conversations, settings and the password all live in the volume mounted at /home/aircode. Deleting the volume deletes them.

To update, pull the new image and recreate the container. Next to compose.yaml:

docker compose pull && docker compose up -d

With docker run, run docker pull aircodezero/aircode:stable, then docker stop aircode && docker rm aircode, then the same docker run command.

A container never starts a release older than one its volume already ran. If the server process stops, the container restarts it, and agent sessions survive that restart. docker exec -it aircode bash opens a shell with the aircode command line, for example aircode password reset.

Not included: Gemini CLI, Antigravity CLI, and the browser used by the browser agent (aircode browser install adds it).

⁠Related images

• aircodezero/session-runtime is a different image. It does not contain the AirCode Ø server.
• AirCode Ø Hosted is the managed service: it starts in your browser, with no server to run. This image is for a server you run yourself.