Skip to content

reach server

Start and manage REACH Core services.

Inspect supported protocols

reach server protocols

Start public server

reach server start --role public --host 0.0.0.0 --port 8000

Start admin server

reach server start --role admin --host 127.0.0.1 --port 8001

Start both public and admin

reach server start --role both --port 8000

In both mode, admin defaults to --port + 1 unless overridden.

Useful options

  • --preset <file> load JSON config
  • --port-public and --port-admin split listeners explicitly
  • --protocol http|ftp|wss choose public protocol for single-protocol mode
  • --docker run through Docker from CLI

HTTPS / TLS note

Native HTTPS termination is not yet implemented directly in REACH core.

Recommended operator pattern:

  • Terminate TLS at an edge layer (Cloudflare Tunnel, Nginx, Traefik, Caddy, LB).
  • Forward HTTP traffic to REACH public listener (for example http://127.0.0.1:8000).

Example (Cloudflare Tunnel):

cloudflared tunnel --url http://127.0.0.1:8000

For configuration precedence and preset structure, see ../operations/config.md. For protocol and TLS architecture notes, see ../core/protocols/protocols.md.