1apptainer(1)                                                      apptainer(1)
2
3
4

NAME

6       apptainer-push - Upload image to the provided URI
7
8
9

SYNOPSIS

11       apptainer push [push options...]
12
13
14

DESCRIPTION

16       The 'push' command allows you to upload a SIF container to a given
17         URI.  Supported URIs include:
18
19
20       library:
21             library://user/collection/container[:tag]
22
23
24       oras:
25             oras://registry/namespace/image:tag
26
27
28       NOTE: It's always good practice to sign your containers before
29         pushing them to the library. An auth token is required to push to the
30       library,
31         so you may need to configure it first with 'apptainer remote'.
32
33
34

OPTIONS

36       -U, --allow-unsigned[=false]      do not require a signed container im‐
37       age
38
39
40       -D,  --description=""       description for container image (library://
41       only)
42
43
44       --docker-host=""      specify a custom Docker daemon host
45
46
47       -h, --help[=false]      help for push
48
49
50       --library=""      the library to push to
51
52
53       --no-https[=false]      use http instead of https for docker:// oras://
54       and library:///... URIs
55
56
57

EXAMPLE

59                To Library
60                $ apptainer push /home/user/my.sif library://user/collection/my.sif:latest
61
62                To supported OCI registry
63                $ apptainer push /home/user/my.sif oras://registry/namespace/image:tag
64
65
66
67

SEE ALSO

69       apptainer(1)
70
71
72

HISTORY

74       22-Nov-2023 Auto generated by spf13/cobra
75
76
77
78Auto generated by spf13/cobra      Nov 2023                       apptainer(1)