opencode-serverlisted

# OpenCode Server > **📚 Official Docs:** For the latest information, always refer to the official documentation: > [https://opencode.ai/docs/server/](https://opencode.ai/docs/server/) OpenCode exposes a headless HTTP server that implements a full REST API and publishes an OpenAPI 3.1 specification. The TUI is a client that talks to this server. The server enables multiple clients (TUI, web, IDE plugins, custom integrations) to control OpenCode programmatically. --- ## Usage Start a standalone HTTP server: ```bash opencode serve [--port <number>] [--hostname <string>] [--mdns] [--mdns-domain <string>] [--cors <origin>] ``` ### Flags | Flag | Description | Default | |------|-------------|---------| | `--port` | Port to listen on | `0 (random available port)` | | `--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 (repeatable) | `[]` | The `--cors` flag can be passed multiple times: ```bash opencode serve --cors http://localhost:5173 --cors https://app.example.com ``` When you run `opencode` normally (without `serve`), it starts both a TUI and an internal server. The TUI is the client that talks to this server. Running `opencode serve` starts a standalone headless server without launching the TUI. --- ## Authentication Protect the server with HTTP basic auth using environment variables: | Var