---
project:
  name: OpenCode Cluster
  status: active
  category: infrastructure
  source: live-verification
  created: 2026-04-19
  updated: 2026-04-19
  description: OpenCode AI coding assistant cluster deployment across homelab hosts
  tags: [infrastructure, opencode, ai, cluster]
---

# OpenCode Cluster Deployment

OpenCode AI coding assistant deployed as systemd services across the homelab cluster.

## Instances

| Instance | Host | Port | Traefik Route | Status |
|----------|------|------|---------------|--------|
| ubuntu | 192.168.50.61 | 4096 | opencode.tophermayor.com | Active/Enabled |
| ice | 192.168.50.197 | 4096 | opencode-ice.tophermayor.com | Active/Enabled |
| grizzley | 192.168.50.84 | 4096 | — | Inactive/Disabled |

## Service Management

All instances run as `opencode-web.service` via systemd:

```bash
# Check status
systemctl status opencode-web

# Restart
sudo systemctl restart opencode-web

# View logs
journalctl -u opencode-web -f
```

## Shared Infrastructure

- **Qdrant** (192.168.50.61:6333) — Shared vector memory backend
- **Ollama** (192.168.50.61:11434) — Local embedding generation

## Configuration

Per-host config files in `homelab/<host>/opencode/`:
- `opencode.json` — Main OpenCode configuration
- `oh-my-opencode.json` — Framework configuration

## Traefik Routing

OpenCode instances use dedicated Traefik middlewares:
- `local-only@file` — IP whitelist
- `opencode-streaming@file` — SSE support
- `opencode-cors@file` — CORS headers

## Related

- [[../architecture.md|Homelab Architecture]]
- [[../../homelab/raw/articles/ai-assistant/project.md|AI Assistant Configuration]]