About this project

Opencode Server is a production-ready Ubuntu 26.04 Docker image designed to run opencode, an AI-powered coding assistant from anomalyco. The image is published to Docker Hub as sprisa/opencode and is built for both Docker and Kubernetes environments. The image ships with a dedicated opencode user (uid/gid 1000) with passwordless sudo, Linux-native Homebrew, zerobrew for faster package installation, and mise as a dev tool manager. A curated set of tools—including GitHub CLI, jq, GitLab CLI, ripgrep, fd, Node.js, Python 3, and various editors—install lazily on first use via mise backends, keeping the base image minimal. Three operational modes are supported: web desktop, server, and CLI. The server listens on port 4096 by default and can be configured via environment variables for authentication (OPENCODE_SERVER_PASSWORD), CORS (OPENCODE_CORS_ORIGIN), logging (OPENCODE_PRINT_LOGS, OPENCODE_LOG_LEVEL), and background tool installation (OPENCODE_INSTALL_HOME_TOOLS). The root filesystem is ephemeral; users are expected to mount /home/opencode as a persistent volume for dotfiles, configuration, and projects, with ~/workspace as the default working directory. The project uses task as its build orchestrator, reading a pinned version from version.txt. Commands cover local builds, Docker Hub login and multi-arch pushes (amd64/arm64), and GitHub Release publishing with auto-generated notes. A task update command fetches the latest opencode release and updates the pinned version. The image is used in production at www.codeplace.app.