20 lines
1.4 KiB
Markdown
20 lines
1.4 KiB
Markdown
# Public Production Ports
|
|
|
|
TrapOS public production services use the `4242-4244` TCP range. Keep local developer defaults separate from these public ports so tests and local tools can run without binding production-facing addresses.
|
|
|
|
| Port | Service | Notes |
|
|
|---|---|---|
|
|
| `4242` | opencode server HTTP API | Production/public port for `opencode serve`. Local/dev examples may still use opencode's default `4096`. |
|
|
| `4243` | ComputerCraft bridge WebSocket | Production/public equivalent of the local bridge link default `3001`. Use `CC_LINK_PORT=4243` for production bridge deployments. |
|
|
| `4244` | Reserved | Free public production port reserved for a future service. Do not assign it casually in local tooling. |
|
|
| `4444` | trap-sandbox gateway | Fastify service (`tools/trap-sandbox`) exposing the `trapos-cloud-gateway` WebSocket at `/gateway`. Sits **outside** the `4242-4244` range on purpose (4244 stays reserved). Default `SANDBOX_PORT`; serve with `just sandbox-serve`. |
|
|
|
|
## Local Vs Production
|
|
|
|
- Local/dev opencode: `http://127.0.0.1:4096`.
|
|
- Public/production opencode: `http://<public-host>:4242`.
|
|
- Local/dev ComputerCraft bridge link: `ws://<host>:3001`.
|
|
- Public/production ComputerCraft bridge link: `ws://<public-host>:4243`.
|
|
|
|
Production services exposed on public ports should use the normal deployment controls for the host: authentication where supported, firewall rules, and TLS or a reverse proxy when crossing untrusted networks.
|