Skip to main content
Convert an existing container image into a base image and upload it to nscr.io. base-image upload pulls an existing container image (from any registry), turns it into a Namespace base image, and pushes it to your nscr.io registry. This is a convenient alternative to building and pushing the image yourself when you already have an image you want to use as a base image.

Usage

Example

Optional Flags

—annotate-with-digest stringToString

Add an annotation to the base image with the digest of a specified path. Example: nix.store-digest=/nix.

—dry-run

Pull the source image and calculate annotations without pushing to nscr.io.
Last modified on August 20, 2026