smanx/opencode

OpenCode Web (Docker)

An out-of-the-box Docker image for running opencode web on Ubuntu. It installs OpenCode via the official installer and starts the web service on 0.0.0.0:4096 by default. Host and port can be customized via environment variables.

https://github.com/smanx/free-api/blob/master/README_EN.md

This API key is publicly shared. Do not rely on it for production workloads or other critical use cases.

Run

bash
docker run -itd --name opencode -p 4096:4096 \
  -v opencode-config:/root/.config/opencode \
  -v opencode-data:/root/.local/share/opencode \
  smanx/opencode

To use your project directory as the workspace:

bash
docker run -itd --name opencode -p 4096:4096 \
  -v opencode-config:/root/.config/opencode \
  -v opencode-data:/root/.local/share/opencode \
  -v "$(pwd)":/workspace \
  smanx/opencode

Persistence

Required (recommended to persist):

• Config: /root/.config/opencode (contains opencode.jsonc)
• Data: /root/.local/share/opencode (contains auth.json, opencode.db, log/, storage/)

Optional:

• State: /root/.local/state/opencode
• Cache: /root/.cache/opencode

Optional with Docker named volumes:

bash
docker run -itd --name opencode -p 4096:4096 \
  -v opencode-config:/root/.config/opencode \
  -v opencode-data:/root/.local/share/opencode \
  -v opencode-state:/root/.local/state/opencode \
  -v opencode-cache:/root/.cache/opencode \
  smanx/opencode

Open:

• http://localhost:4096

Port / Host

Defaults:

• OPENCODE_HOSTNAME=0.0.0.0
• OPENCODE_PORT=4096

Custom port example:

bash
docker run -itd --name opencode -p 8080:8080 \
  -e OPENCODE_PORT=8080 \
  smanx/opencode

Custom hostname example:

bash
docker run -itd --name opencode -p 4096:4096 \
  -e OPENCODE_HOSTNAME=0.0.0.0 \
  smanx/opencode

Web Options

All extra arguments are forwarded to opencode web.

Supported flags (same as the upstream docs):

text
--port <number>
--hostname <string>
--mdns
--mdns-domain <string>
--cors <origin>        # can be provided multiple times
--log-level <level>    # DEBUG|INFO|WARN|ERROR
--print-logs

Examples:

bash
docker run -itd --name opencode -p 4096:4096 \
  smanx/opencode --mdns

bash
docker run -itd --name opencode -p 4096:4096 \
  smanx/opencode --cors https://example.com

bash
docker run -itd --name opencode -p 4096:4096 \
  smanx/opencode --hostname 0.0.0.0 --port 4096 --mdns --mdns-domain myproject.local \
  --cors https://example.com --cors https://foo.example \
  --log-level INFO --print-logs

You can also configure these via environment variables:

bash
docker run -itd --name opencode -p 4096:4096 \
  -e OPENCODE_MDNS=true \
  -e OPENCODE_MDNS_DOMAIN=myproject.local \
  -e OPENCODE_CORS=https://example.com,https://foo.example \
  -e OPENCODE_LOG_LEVEL=INFO \
  -e OPENCODE_PRINT_LOGS=true \
  smanx/opencode

Authentication (Recommended)

bash
docker run -itd --name opencode -p 4096:4096 \
  -e OPENCODE_SERVER_USERNAME=opencode \
  -e OPENCODE_SERVER_PASSWORD=secret \
  smanx/opencode

---

OpenCode Web (Docker)

一个开箱即用的 opencode Web 容器镜像：基于 Ubuntu，通过官方安装脚本安装 opencode，容器启动后默认在 0.0.0.0:4096 运行 opencode web，并支持通过环境变量自定义监听地址和端口。

https://github.com/smanx/free-api

该 Key 为公开共享用途，请勿用于生产环境中的强依赖场景

运行

bash
docker run -itd --name opencode -p 4096:4096 \
  -v opencode-config:/root/.config/opencode \
  -v opencode-data:/root/.local/share/opencode \
  smanx/opencode

把当前项目目录作为工作区：

bash
docker run -itd --name opencode -p 4096:4096 \
  -v opencode-config:/root/.config/opencode \
  -v opencode-data:/root/.local/share/opencode \
  -v "$(pwd)":/workspace \
  smanx/opencode

持久化

必须映射（建议持久化）：

• 配置：/root/.config/opencode（包含 opencode.jsonc，provider/model 配置等）
• 数据：/root/.local/share/opencode（包含 auth.json、opencode.db、log/、storage/）

可选项（按需）：

• state：/root/.local/state/opencode
• cache：/root/.cache/opencode

可选项示例（使用 Docker volume）：

bash
docker run -itd --name opencode -p 4096:4096 \
  -v opencode-config:/root/.config/opencode \
  -v opencode-data:/root/.local/share/opencode \
  -v opencode-state:/root/.local/state/opencode \
  -v opencode-cache:/root/.cache/opencode \
  smanx/opencode

浏览器打开：

• http://localhost:4096

端口 / Host

默认值：

• OPENCODE_HOSTNAME=0.0.0.0
• OPENCODE_PORT=4096

自定义端口示例：

bash
docker run -itd --name opencode -p 8080:8080 \
  -e OPENCODE_PORT=8080 \
  smanx/opencode

自定义 Host 示例：

bash
docker run -itd --name opencode -p 4096:4096 \
  -e OPENCODE_HOSTNAME=0.0.0.0 \
  smanx/opencode

Web 参数

镜像名后面的参数会原样转发给 opencode web。

支持的参数（与官方文档一致）：

text
--port <number>
--hostname <string>
--mdns
--mdns-domain <string>
--cors <origin>        # 可多次传入
--log-level <level>    # DEBUG|INFO|WARN|ERROR
--print-logs

示例：

bash
docker run -itd --name opencode -p 4096:4096 \
  smanx/opencode --mdns

bash
docker run -itd --name opencode -p 4096:4096 \
  smanx/opencode --cors https://example.com

bash
docker run -itd --name opencode -p 4096:4096 \
  smanx/opencode --hostname 0.0.0.0 --port 4096 --mdns --mdns-domain myproject.local \
  --cors https://example.com --cors https://foo.example \
  --log-level INFO --print-logs

也可以通过环境变量配置：

bash
docker run -itd --name opencode -p 4096:4096 \
  -e OPENCODE_MDNS=true \
  -e OPENCODE_MDNS_DOMAIN=myproject.local \
  -e OPENCODE_CORS=https://example.com,https://foo.example \
  -e OPENCODE_LOG_LEVEL=INFO \
  -e OPENCODE_PRINT_LOGS=true \
  smanx/opencode

认证（建议开启）

bash
docker run -itd --name opencode -p 4096:4096 \
  -e OPENCODE_SERVER_USERNAME=opencode \
  -e OPENCODE_SERVER_PASSWORD=secret \
  smanx/opencode