carta
singularity-push(1)

singularity-push1

Upload image to the provided uri

Usage

apptainer push [push options ...]

Overview

The 'push' command allows you to upload a SIF container to a given
URI. Supported URIs include:

library:
library://user/collection/container[:tag]

oras:
oras://registry/namespace/image:tag

NOTE: It's always good practice to sign your containers before
pushing them to the library. An auth token is required to push to the library,
so you may need to configure it first with 'apptainer remote'.

Options

-U, --allow-unsigned[=false]
do not require a signed container image

--authfile=""
Docker-style authentication file to use for writing/reading OCI registry credentials

-D, --description=""
description for container image (library:// only)

--docker-host=""
specify a custom Docker daemon host

-h, --help[=false]
help for push

--library=""
the library to push to

--no-https[=false]
use http instead of https for docker:// oras:// and library:///... URIs

Examples

  To Library
  $ apptainer push /home/user/my.sif library://user/collection/my.sif:latest
  To supported OCI registry
  $ apptainer push /home/user/my.sif oras://registry/namespace/image:tag

History

22-Sep-2026 Auto generated by spf13/cobra

From apptainer 1.5.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.