Skip to content

feat(containers): add docker server image for opencode code server#19475

Open
andreclaudino wants to merge 8 commits intoanomalyco:devfrom
andreclaudino:feature/docker-server
Open

feat(containers): add docker server image for opencode code server#19475
andreclaudino wants to merge 8 commits intoanomalyco:devfrom
andreclaudino:feature/docker-server

Conversation

@andreclaudino
Copy link
Copy Markdown

@andreclaudino andreclaudino commented Mar 28, 2026

Issue for this PR

Closes #19474

Type of change

  • Bug fix
  • New feature
  • Refactor / code improvement
  • Documentation

What does this PR do?

This PR adds official Docker images for running OpenCode as a headless server, enabling:

  • Integration with VS Code, JetBrains IDEs, and other editors via the OpenCode server protocol
  • Isolated execution in containers without affecting the host system
  • CI/CD pipeline integration
  • Multi-user development environments
  • Dev Containers integration via the included devcontainer CLI

Changes made

  1. Dockerfiles: Added Debian Trixie and Alpine Linux variants for the server image
  2. CI/CD: GitHub Actions workflow for automated GHCR builds
  3. Build script: Local build script for development
  4. Documentation: Full documentation in 22 languages
  5. README updates: Added Docker Server section to all README files

How did you verify your code works?

  • Dockerfiles follow the existing project container patterns
  • Build configuration is compatible with the project's CI/CD infrastructure
  • Documentation follows the project's existing style

Checklist

  • I have tested my changes locally
  • I have not included unrelated changes in this PR

@github-actions github-actions bot added needs:compliance This means the issue will auto-close after 2 hours. and removed needs:compliance This means the issue will auto-close after 2 hours. labels Mar 28, 2026
@github-actions
Copy link
Copy Markdown
Contributor

Thanks for updating your PR! It now meets our contributing guidelines. 👍

@colinandres885-boop
Copy link
Copy Markdown

Run the server

docker run -p 3000:3000 -v /path/to/workspace:/workspace ###

ghcr.io/anomalyco/opencode:dev-debian

With SSH keys for git

docker run -p 3000:3000 -v ~/.ssh:/home/opencode/.ssh ghcr.io/anomalyco/opencode:dev-debian

Using docker-compose

services:
opencode:
image: ghcr.io/anomalyco/opencode:dev-debian
ports:
- "3000:3000"
volumes:
- ./workspace:/workspace
- ~/.ssh:/home/opencode/.ssh
- ~/.gitconfig:/home/opencode/.gitconfig[](url)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature Request] Add Docker Server Image for OpenCode Code Server

2 participants