diff options
| author | Luiz Guilherme D'Abruzzo Pereira <[email protected]> | 2026-02-03 10:26:42 -0300 |
|---|---|---|
| committer | GitHub <[email protected]> | 2026-02-03 07:26:42 -0600 |
| commit | 95d0d476e306e0767e569466e39152390e7024d1 (patch) | |
| tree | e0da7fe31c604fa0c0a1787cb851fd59c36451c2 | |
| parent | 7508839b708844df3b6fc5afec641e3f2beb4f9d (diff) | |
| download | opencode-95d0d476e306e0767e569466e39152390e7024d1.tar.gz opencode-95d0d476e306e0767e569466e39152390e7024d1.zip | |
docs: add --mdns-domain flag documentation (#11933)
| -rw-r--r-- | packages/web/src/content/docs/config.mdx | 2 | ||||
| -rw-r--r-- | packages/web/src/content/docs/server.mdx | 13 | ||||
| -rw-r--r-- | packages/web/src/content/docs/web.mdx | 6 |
3 files changed, 15 insertions, 6 deletions
diff --git a/packages/web/src/content/docs/config.mdx b/packages/web/src/content/docs/config.mdx index 1474cb915..5cc9d8666 100644 --- a/packages/web/src/content/docs/config.mdx +++ b/packages/web/src/content/docs/config.mdx @@ -190,6 +190,7 @@ You can configure server settings for the `opencode serve` and `opencode web` co "port": 4096, "hostname": "0.0.0.0", "mdns": true, + "mdnsDomain": "myproject.local", "cors": ["http://localhost:5173"] } } @@ -200,6 +201,7 @@ Available options: - `port` - Port to listen on. - `hostname` - Hostname to listen on. When `mdns` is enabled and no hostname is set, defaults to `0.0.0.0`. - `mdns` - Enable mDNS service discovery. This allows other devices on the network to discover your OpenCode server. +- `mdnsDomain` - Custom domain name for mDNS service. Defaults to `opencode.local`. Useful for running multiple instances on the same network. - `cors` - Additional origins to allow for CORS when using the HTTP server from a browser-based client. Values must be full origins (scheme + host + optional port), eg `https://app.example.com`. [Learn more about the server here](/docs/server). diff --git a/packages/web/src/content/docs/server.mdx b/packages/web/src/content/docs/server.mdx index 7229e09b2..4510bd498 100644 --- a/packages/web/src/content/docs/server.mdx +++ b/packages/web/src/content/docs/server.mdx @@ -18,12 +18,13 @@ opencode serve [--port <number>] [--hostname <string>] [--cors <origin>] #### Options -| Flag | Description | Default | -| ------------ | ----------------------------------- | ----------- | -| `--port` | Port to listen on | `4096` | -| `--hostname` | Hostname to listen on | `127.0.0.1` | -| `--mdns` | Enable mDNS discovery | `false` | -| `--cors` | Additional browser origins to allow | `[]` | +| Flag | Description | Default | +| --------------- | ----------------------------------- | ---------------- | +| `--port` | Port to listen on | `4096` | +| `--hostname` | Hostname to listen on | `127.0.0.1` | +| `--mdns` | Enable mDNS discovery | `false` | +| `--mdns-domain` | Custom domain name for mDNS service | `opencode.local` | +| `--cors` | Additional browser origins to allow | `[]` | `--cors` can be passed multiple times: diff --git a/packages/web/src/content/docs/web.mdx b/packages/web/src/content/docs/web.mdx index 1013712f3..52b97460c 100644 --- a/packages/web/src/content/docs/web.mdx +++ b/packages/web/src/content/docs/web.mdx @@ -64,6 +64,12 @@ opencode web --mdns This automatically sets the hostname to `0.0.0.0` and advertises the server as `opencode.local`. +You can customize the mDNS domain name to run multiple instances on the same network: + +```bash +opencode web --mdns --mdns-domain myproject.local +``` + ### CORS To allow additional domains for CORS (useful for custom frontends): |