Reference
Ports, files, scripts, and maturity
A compact, code-aligned reference for the common operator values.
Repository-validated operator guidance View source ↗
#Ports
| Port | Service | Production exposure |
|---|---|---|
| 80, 443/TCP | Public proxy | Public when serving the panel and TLS. |
| 8080/TCP | Forge API | Loopback in compose.production.yml. |
| 3000/TCP | Forge Web | Loopback in compose.production.yml. |
| 5432/TCP | PostgreSQL | Loopback in compose.production.yml; never public. |
| 6379/TCP | Redis | Loopback in compose.production.yml; never public. |
| 9090/TCP | Beacon API | Loopback all-in-one; private in multi-node deployments. |
| 2022/TCP | Beacon SFTP | Restrict deliberately; default bind is loopback in supplied Beacon Compose. |
| 30000–30100/TCP+UDP | Load-balancer allocation range | Published by compose.production.yml when enabled. |
#Important files
| Path | Purpose |
|---|---|
| infra/.env | Runtime secrets and deployment configuration. |
| infra/compose.yml | Base control-plane Compose stack. |
| infra/compose.production.yml | Production loopback bindings and restart policies. |
| infra/compose.beacon.yml | Standalone Beacon Compose deployment. |
| infra/compose.tls.yml | Traefik ACME and internal TLS override. |
| infra/Caddyfile | Baseline Caddy configuration for local hostnames. |
| scripts/healthcheck.sh | Compose, API, Beacon, Web, database, and monitoring checks. |
| scripts/rollback.sh | Database/image rollback helper. |
#Feature maturity
| Area | Current position |
|---|---|
| One-host Compose stack | Available |
| Standalone Beacon Compose | Available |
| Node Docker and file execution | Available |
| Shared backup restore workflow | Available when storage is configured and tested |
| Automatic stateful failover | Not currently available |
| Load-balancer target selection | Partially implemented; proxy deployment must be validated |
| Cloud provisioning bootstrap | Experimental; verify node enrollment and hardening |
| Caddy public production configuration | Requires operator adaptation; supplied Caddyfile is local-hostname oriented |