cc-libs/docs/public-ports.md

1.3 KiB

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 Reserved Formerly the ComputerCraft bridge WebSocket (removed with tools/mcp-bridge). Free for a future service.
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.

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.