> ## Documentation Index
> Fetch the complete documentation index at: https://namespace.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# nsc base-image upload

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

```bash theme={null}
nsc base-image upload [source-image] [target-tag] [flags]
```

### Example

```bash theme={null}
nsc base-image upload ubuntu:24.04 my-worker:latest
```

## Optional Flags

<h3 id="--annotate-with-digest-stringtostring">
  \--annotate-with-digest stringToString
</h3>

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

<h3 id="--dry-run">
  \--dry-run
</h3>

Pull the source image and calculate annotations without pushing to `nscr.io`.

## Related Topics

* [nsc base-image optimize](/docs/reference/cli/base-image-optimize) - Optimize a base image for fast worker boot
* [nsc build](/docs/reference/cli/build) - Build container images using Namespace Remote Builders
* [Bazel Remote Execution](/docs/bazel/execution) - Use custom worker images with RBE