docker buildx setup configures the local Docker’s buildx plugin to use the Namespace Remote Builders.
So the following docker build commands will use a high-capacity remote builder hosted by Namespace.
The builder machines are created on demand whenever a build is started, triggering a connection to the remote builders.
The architecture of the builder machine (AMD64 or ARM64) is inferred by the build command’s platform.
Usage
Example
The following example configures localbuildx to use Namespace Remote Builders.
1
Configure buildx
Configure
buildx to use Namespace Remote Builders:2
Build an image
Run a Docker build using the configured Remote Builder:
Options
—name <name>
Specify the local name of thebuildx builder. By default, it is “nsc-remote”. Use --tag to select a named remote builder.
—state <path>
Specify a custom directory where the command stores the remote builders context configuration.—tag <tag>
If set, targets a specific remote builder instead of letting Namespace select one automatically. Requires named builders to be enabled for your workspace. See Named Builders for setup examples and prerequisites.—builder_shape <vcpu>x<memGB>
Request a builder shape, such as32x64 for 32 vCPUs and 64 GB of memory. Requires builder customization to be enabled for your workspace. Contact support@namespace.so to request access. If omitted, Namespace uses your workspace’s default builder shape.
—platform stringArray (can be repeated)
Only set up builders for the specified platforms. Acceptsamd64 or arm64, optionally prefixed with linux/. Repeat the flag to select multiple platforms.
—background
If set, runs the proxy in the background. So,nsc docker buildx setup does not block the caller.
—create_at_startup
By default, Remote Builders are created on demand, whenever a new build request is issued. If this flag is set, the Remote Builders are created immediately.—force_cleanup
If set, forces cleanup of any previousbuildx proxy already running in the background before setting up a new one. Useful if a prior --background run wasn’t shut down cleanly.
—use
If set, it configures local Docker context to use the Namespace Remote Builders. By default, it only configures the builders indocker buildx, and it does not change the Docker context.
—wait-for-builder duration[=5m]
Wait for the selected remote builders to be ready. Uses5m when the flag is passed without a value, or accepts an explicit duration such as --wait-for-builder=30s. Requires --platform and the server-side proxy.