Public Access

Files

T

joakimp 3dfc14c6c1 Initial scaffold: Debian-based opencode v1.4.0 dev container

Dockerfile with Node.js 22, git, ssh, fzf, ripgrep, fd, non-root user.
Entrypoint auto-configures provider from env vars.
docker-compose with workspace mount, SSH keys, and persistent data volume.

2026-04-09 00:26:48 +02:00

2.9 KiB

Raw Blame History

opencode-devbox

Portable AI developer environment in a Docker container. Run opencode on any Docker-capable machine with configurable LLM providers, dev tools, and host filesystem access.

Why?

The official ghcr.io/anomalyco/opencode image (now archived) was Alpine-based and minimal — no git, no dev tools, broken PTY support due to musl/glibc incompatibility. This project provides a Debian-based, production-ready alternative using the current v1.x release.

Quick Start

# Clone
git clone ssh://gitea.jordbo.se:2222/joakimp/opencode-devbox.git
cd opencode-devbox

# Configure
cp .env.example .env
# Edit .env with your provider, API key, workspace path, git config

# Build and run
docker compose run --rm devbox

Features

Debian bookworm base — glibc, full PTY/terminal support
Configurable providers — Anthropic, OpenAI, AWS Bedrock via env vars
Host filesystem access — bind mount any directory as /workspace
SSH key forwarding — git push/pull to private repos
MCP server support — Node.js included for npx-based MCP servers
Non-root user — runs as developer (UID 1000) with sudo
Optional runtimes — Python, Go via build args (Node.js always included — required for opencode v1.x)
Multi-arch — amd64 and arm64

Configuration

Environment Variables

Variable	Description	Default
`OPENCODE_PROVIDER`	LLM provider (`anthropic`, `openai`, `amazon-bedrock`)	`anthropic`
`OPENCODE_MODEL`	Model override	Provider default
`ANTHROPIC_API_KEY`	Anthropic API key	—
`OPENAI_API_KEY`	OpenAI API key	—
`AWS_REGION`	AWS region for Bedrock	`us-east-1`
`GIT_USER_NAME`	Git commit author name	—
`GIT_USER_EMAIL`	Git commit author email	—
`WORKSPACE_PATH`	Host path to mount	`.`
`SSH_KEY_PATH`	Host SSH key directory	`~/.ssh`

Custom opencode config

Mount your own opencode.json for full control (MCP servers, custom models, etc.):

volumes:
  - ./my-opencode.json:/home/developer/.config/opencode/opencode.json:ro

Build Args

Enable optional language runtimes:

docker compose build --build-arg INSTALL_PYTHON=true --build-arg INSTALL_GO=true

Arg	Default	Description
`INSTALL_PYTHON`	`false`	Python 3 + pip + venv
`INSTALL_GO`	`false`	Go toolchain

Architecture

Host Machine
├── ~/projects/my-app  ──bind mount──▶  /workspace (container)
├── ~/.ssh             ──bind mount──▶  /home/developer/.ssh (ro)
└── .env               ──env vars───▶  provider config + API keys

Container (Debian bookworm)
├── opencode binary
├── git, ssh, ripgrep, fd, jq, curl
├── Node.js (for MCP servers)
├── entrypoint.sh (SSH perms, git config, provider setup)
└── /workspace ← your code lives here

License

MIT

2.9 KiB Raw Blame History