CI/CD runner container images for Forge.
This repository builds and publishes the runner images that Forge uses to execute CI/CD pipelines. See SPEC.md for the full specification.
Two image families are produced (single public repository):
| Family | Base | Built from |
|---|---|---|
| Linux | Ubuntu (buildpack-deps) + act tools | vendored upstream build assets |
| Windows | Windows Server Core (ltsc2022/ltsc2025) | authored Dockerfile |
Image repository: docker.io/<namespace>/forge-runners
.github/workflows/
build-linux.yml # Linux image build/publish (workflow_dispatch)
build-windows.yml # Windows image build/publish (workflow_dispatch)
docker/forge-runner-images/
linux/ubuntu/
Dockerfile # generic, one Dockerfile for every Linux variant
scripts/ # vendored upstream install scripts (+ helpers/)
windows/
Dockerfile # authored Server Core image (tools + .NET SDK)
build.ps1 # build/publish driver (-OS linux|windows)
NOTICE # upstream attribution
The two workflows are independent: run either one from the Actions tab without rebuilding the
other. Both need repository secrets DOCKERHUB_USERNAME and DOCKERHUB_TOKEN.
Linux (local, single-arch):
pwsh docker/forge-runner-images/build.ps1 -OS linux -Types act,dotnet
Linux (publish, multi-arch):
pwsh docker/forge-runner-images/build.ps1 -OS linux -Types act,dotnet -Platforms 'linux/amd64,linux/arm64' -Push
Windows (build each base on a matching host):
pwsh docker/forge-runner-images/build.ps1 -OS windows -WindowsTag ltsc2022,ltsc2025 -Push
Authenticate to the registry separately (docker login); no credentials are embedded.
MIT (see LICENSE). Vendored third-party assets are attributed in NOTICE.
Content type
Image
Digest
sha256:0a4544059…
Size
977.4 MB
Last updated
11 days ago
docker pull surgicalcoder/forge-runners:dotnet-latest