updated opencode readme

This commit is contained in:
2026-06-27 08:25:40 -07:00
parent 26bff0c2c1
commit 5d0eddeea4
+53 -5
View File
@@ -13,12 +13,60 @@ OpenCode is an open source AI coding agent.
## Config file
You can copy the config.json file to your volume. Change the model and host data to your settings.
The `config.json` at `opencode/config/config.json` is pre-configured for
Ollama. Available models include:
## Gotcha
| Model | Default | Purpose |
|---|---|---|
| `qwen2.5-coder:14b` | default | Coding & agent tasks (recommended for this repo) |
| `qwen3:8b` / `qwen3:8b-16k` | | General purpose, tool support |
| `qwen2.5:7b` | | Lightweight general purpose |
| `mistral:latest` / `mistral-small3.2:latest` | | Chat & multilingual |
| `llama3.1:8b` | | General purpose |
Config ollama: https://github.com/p-lemonish/ollama-x-opencode
Tested on an NVIDIA GeForce RTX 5060 Ti (16 GB VRAM).
## ENV
To use a custom config with `VOL_PATH=/data`, copy it to:
OPENCODE_SERVER_PASSWORD (complains if not set)
```
/data/opencode/config/config.json
```
## Ollama
This stack requires the [ollama](../ollama/) stack to be running. The config
connects to `http://localhost:11434/v1` inside the container.
To use a host-side ollama instead, set `OLLAMA_HOST=http://host.docker.internal:11434`.
## Environment Variables
- `OPENCODE_SERVER_PASSWORD` — required. Set a strong password for the web UI.
- `OLLAMA_HOST` — Ollama API endpoint (default `http://localhost:11434`)
- `OPENCODE_PORT` — Web UI port (default `4096`)
- `VOL_PATH` — Base path for persistent data (default `/data`)
## Volume Notes
With `VOL_PATH=/data`:
| Container path | Host path | Purpose |
|---|---|---|
| `/config` | `/data/opencode/config` | Config files (config.json) |
| `/data` | `/data/opencode/data` | OpenCode state |
| `/projects` | `/data/opencode/projects` | Workspace/project files |
## Network Notes
Requires proxy network
## dockhand Stack, Deploy from Git
Cookbooks Repository
stackname: opencode
Compose file path: opencode/compose.yaml
Additional env file (optional): opencode/sample.env
Then "Load" opencode/sample.env into the Environmental variables in dockhand.
Create the Stack