Introduction
AI Dev Server (ai-dev) is an immutable Ubuntu 24.04 terminal development environment for linux/amd64 and linux/arm64.
It ships as a Docker image with:
- Docker CLI, Compose, and Buildx (via the host Docker socket)
- Language toolchains (Node.js, pnpm, Bun, Python/uv, Go, Rust, OpenJDK, and more)
- AI coding tools: Claude Code, Codex CLI, Oh My ClaudeCode (OMC), Oh My Codex (OMX), and SaladDay
cc-switch-cli - Terminal essentials such as Zsh, tmux, Git, and GitHub CLI
Projects, credentials, tool state, logs, models, and backups live in named volumes, not in the image.
What it is not
- Not a browser-based product UI or web-terminal product surface
- Not an in-container SSH service
- Not a multi-tenant SaaS
Compose does not publish an application HTTP port. You enter with scripts/shell or scripts/tmux.
Security first
The Compose service mounts /var/run/docker.sock read-write. Access to the raw Docker socket is effectively host-root access. Use this only on a trusted, single-user server with trusted repositories and tools. Read Security before starting.
Default image
docker.io/jerry0510/ai-dev:latest
Override with AI_DEV_IMAGE when you need a pinned tag, mirror, or local build.