Publish cf-orch Docker image to GHCR for paid+ multi-node users #19

New issue

Closed

opened 2026-04-03 08:51:15 -07:00 by pyr0ball · 0 comments

pyr0ball commented

2026-04-03 08:51:15 -07:00

Owner

Context

Paid+ users who want managed multi-node GPU orchestration should be able to self-host the coordinator without installing Python or cf-core from source. A pre-built Docker image makes this a one-liner.

Proposed image

ghcr.io/circuit-forge/cf-orch:latest

Includes:

cf-orch coordinator (FastAPI, port 7700)
cf-orch agent (connects back to coordinator)
All cf-core dependencies pre-installed
Entrypoint: python -m circuitforge_core.resources.cli coordinator

Env vars the image respects

HEIMDALL_URL            # enable Heimdall auth (optional; omit for LAN-only deployments)
HEIMDALL_MIN_TIER       # default: paid
CF_ORCH_AUTH_SECRET     # shared secret with Heimdall
CF_ORCH_PORT            # coordinator listen port (default: 7700)

Tasks

Write Dockerfile for cf-orch coordinator
Write compose.yml example for multi-node (coordinator + agent per GPU node)
Set up GitHub Actions (or Forgejo Actions) CI to build and push on tag
Publish ghcr.io/circuit-forge/cf-orch:latest and cf-orch:v0.x.x
Add pull + run instructions to README

Heimdall issue: Circuit-Forge/heimdall — Add POST /licenses/verify
cf-core commit: 3deae05

## Context Paid+ users who want managed multi-node GPU orchestration should be able to self-host the coordinator without installing Python or cf-core from source. A pre-built Docker image makes this a one-liner. ## Proposed image ``` ghcr.io/circuit-forge/cf-orch:latest ``` Includes: - cf-orch coordinator (FastAPI, port 7700) - cf-orch agent (connects back to coordinator) - All cf-core dependencies pre-installed - Entrypoint: `python -m circuitforge_core.resources.cli coordinator` ## Env vars the image respects ``` HEIMDALL_URL # enable Heimdall auth (optional; omit for LAN-only deployments) HEIMDALL_MIN_TIER # default: paid CF_ORCH_AUTH_SECRET # shared secret with Heimdall CF_ORCH_PORT # coordinator listen port (default: 7700) ``` ## Tasks - [ ] Write `Dockerfile` for cf-orch coordinator - [ ] Write `compose.yml` example for multi-node (coordinator + agent per GPU node) - [ ] Set up GitHub Actions (or Forgejo Actions) CI to build and push on tag - [ ] Publish `ghcr.io/circuit-forge/cf-orch:latest` and `cf-orch:v0.x.x` - [ ] Add pull + run instructions to README ## Related Heimdall issue: Circuit-Forge/heimdall — Add POST /licenses/verify cf-core commit: `3deae05`