Skip to main content
Test the build of a base image. base-image build-github-image performs a test build of a Dockerfile intended for use as a GitHub Actions runner base image. It’s useful for validating that a custom image configuration builds successfully before you upload it or wire it up to a GitHub runner profile. This command is also invokable as nsc github build-base-image — both forms run the exact same command, so don’t be confused if you see either one referenced elsewhere.

Usage

Example

Optional Flags

-f, —file string

Specifies what Dockerfile to build.

-l, —os-label string

Specifies the OS version of the base image. Default: ubuntu-22.04.

-p, —platform strings

Which platforms to build for (linux/amd64 or linux/arm64). Default: linux/amd64,linux/arm64.
Last modified on August 20, 2026