Skip to content

Document OpenCode integration for Docker Model Runner and WSL troubleshooting #24052

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
dvdksn merged 3 commits into from
Feb 2, 2026
Merged

Document OpenCode integration for Docker Model Runner and WSL troubleshooting #24052

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
4c7fda5
Document OpenCode integration for Docker Model Runner and WSL trouble…
tfenster Feb 1, 2026
dfb6dd9
Apply suggestions from code review
tfenster Feb 1, 2026
e407332
Specify JSON format in OpenCode configuration
tfenster Feb 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 36 additions & 0 deletions content/manuals/ai/model-runner/ide-integrations.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -224,6 +224,40 @@ response = llm.complete("Write a hello world function")
print(response.text)
```

## OpenCode

[OpenCode](https://opencode.ai/) is an open-source coding assistant designed to integrate directly into developer workflows. It supports multiple model providers and exposes a flexible configuration system that makes it easy to switch between them.

### Configuration

1. Install OpenCode (see [docs](https://opencode.ai/docs/#install))
2. Reference DMR in your OpenCode configuration, either globally at `~/.config/opencode/opencode.json` or project specific with a `opencode.json` file in the root of your project
```json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"dmr": {
"npm": "@ai-sdk/openai-compatible",
"name": "Docker Model Runner",
"options": {
"baseURL": "http://localhost:12434/v1"
},
"models": {
"ai/qwen2.5-coder": {
"name": "ai/qwen2.5-coder"
},
"ai/llama3.2": {
"name": "ai/llama3.2"
}
}
}
}
}
```
3. Select the model you want in OpenCode

You can find more details in [this Docker Blog post](https://www.docker.com/blog/opencode-docker-model-runner-private-ai-coding/)

## Common issues

### "Connection refused" errors
Expand All @@ -240,6 +274,8 @@ print(response.text)

3. Check if another service is using port 12434.

4. If you run your tool in WSL and want to connect to DMR on the host via `localhost`, this might not directly work. Configuring WSL to use [mirrored networking](https://learn.microsoft.com/en-us/windows/wsl/networking#mirrored-mode-networking) can solve this.

### "Model not found" errors

1. Verify the model is pulled:
Expand Down