cc-libs/docs/public-ports.md

1.2 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 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.

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.