.nh
.TH "singularity" "1" "Feb 2023" "Auto generated by spf13/cobra" ""

.SH NAME
.PP
singularity-push - Upload image to the provided URI


.SH SYNOPSIS
.PP
\fBsingularity push [push options...]  \fP


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

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

.PP
oras:
      oras://registry/namespace/repo:tag

.PP
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 'singularity remote'.


.SH OPTIONS
.PP
\fB-U\fP, \fB--allow-unsigned\fP[=false]
	do not require a signed container image

.PP
\fB-D\fP, \fB--description\fP=""
	description for container image (library:// only)

.PP
\fB-h\fP, \fB--help\fP[=false]
	help for push

.PP
\fB--library\fP=""
	the library to push to


.SH EXAMPLE
.PP
.RS

.nf

  To Library
  $ singularity push /home/user/my.sif library://user/collection/my.sif:latest

  To supported OCI registry
  $ singularity push /home/user/my.sif oras://registry/namespace/image:tag

.fi
.RE


.SH SEE ALSO
.PP
\fBsingularity(1)\fP


.SH HISTORY
.PP
13-Feb-2023 Auto generated by spf13/cobra