.nh
.TH "apptainer" "1" "Apr 2024" "Auto generated by spf13/cobra" ""

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


.SH SYNOPSIS
.PP
\fBapptainer 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/image: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 'apptainer 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--docker-host\fP=""
	specify a custom Docker daemon host

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

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

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


.SH EXAMPLE
.EX

  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

.EE


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


.SH HISTORY
.PP
1-Apr-2024 Auto generated by spf13/cobra