> ## 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 registry share

Share a private nscr.io image publicly.

`nsc registry share` makes a private nscr.io container image publicly accessible. It generates a new unique id which can
be used to pull the image from public.nscr.io.

## Usage

```bash theme={null}
nsc registry share <image-reference> [--digest <digest>] [--expires_at <timestamp>] [--output <table|json>] [--repository <repository>] [--suffix <suffix>] [--visibility <public|partner>]
```

### Example

```sh theme={null}
nsc registry share nscr.io/01gr490qvbntkjn9jwypnd4g04/private@sha256:b493d48364afe44d11c0165cf470a4164d1e2609911ef998be868d46ade3de4e

Shared Image ID:  foo0sasl3o8
Repository:       private
Digest:           sha256:b493d48364afe44d11c0165cf470a4164d1e2609911ef998be868d46ade3de4e
Visibility:       PUBLIC
Expires At:       Never

Shared Reference: public.nscr.io/foo0sasl3o8/test:latest
```

## Options

<h3 id="--digest-digest">
  \--digest \<digest>
</h3>

Image digest used to identify the specific image, in the form `sha256:...`. Use together with `--repository` as an alternative to providing the image reference as a positional argument.

<h3 id="--expires_at-timestamp">
  \--expires\_at \<timestamp>
</h3>

When the image will no longer be accessible publicly. The private image will still exist after this timestamp.

<h3 id="--output--o-format">
  \--output, -o \<format>
</h3>

Output format. One of `table` or `json`. Default is `table`.

<h3 id="--repository-repository">
  \--repository \<repository>
</h3>

Repository name to share. Use together with `--digest` as an alternative to providing the image reference as a positional argument.

<h3 id="--suffix-suffix">
  \--suffix \<suffix>
</h3>

Adds a suffix to the id part of the public reference which makes it easier to distinguish public images.

<h3 id="--visibility-level">
  \--visibility \<level>
</h3>

Visibility level to share the image at. One of `public` or `partner`. Default is `public`.