1singularity(1)                                                  singularity(1)
2
3
4

NAME

6       singularity-pull - Pull an image from a URI
7
8
9

SYNOPSIS

11       singularity pull [pull options...] [output file]
12
13
14

DESCRIPTION

16       The  'pull'  command allows you to download or build a container from a
17       given
18         URI. Supported URIs include:
19
20
21       library: Pull an image from the currently configured library
22             library://user/collection/container[:tag]
23
24
25       docker: Pull a Docker/OCI image from Docker Hub, or  another  OCI  reg‐
26       istry.
27             docker://user/image:tag
28
29
30       shub: Pull an image from Singularity Hub
31             shub://user/image:tag
32
33
34       oras: Pull a SIF image from an OCI registry that supports ORAS.
35             oras://registry/namespace/image:tag
36
37
38       http, https: Pull an image using the http(s?) protocol
39             https://library.sylabs.io/v1/image‐
40       file/library/default/alpine:latest
41
42
43

OPTIONS

45       --arch="amd64"      architecture to pull from library
46
47
48       --dir=""      download images to the specific directory
49
50
51       --disable-cache[=false]      dont use cached images/blobs and dont cre‐
52       ate them
53
54
55       --docker-login[=false]      login to a Docker Repository interactively
56
57
58       -F, --force[=false]      overwrite an image file if it exists
59
60
61       -h, --help[=false]      help for pull
62
63
64       --library=""      download images from the provided library
65
66
67       --no-cleanup[=false]       do  NOT  clean up bundle after failed build,
68       can be helpful for debugging
69
70
71       --nohttps[=false]      do NOT use HTTPS with  the  docker://  transport
72       (useful for local docker registries without a certificate)
73
74
75

EXAMPLE

77                From Sylabs cloud library
78                $ singularity pull alpine.sif library://alpine:latest
79
80                From Docker
81                $ singularity pull tensorflow.sif docker://tensorflow/tensorflow:latest
82
83                From Shub
84                $ singularity pull singularity-images.sif shub://vsoch/singularity-images
85
86                From supporting OCI registry (e.g. Azure Container Registry)
87                $ singularity pull image.sif oras://<username>.azurecr.io/namespace/image:tag
88
89
90
91

SEE ALSO

93       singularity(1)
94
95
96

HISTORY

98       11-Mar-2021 Auto generated by spf13/cobra
99
100
101
102Auto generated by spf13/cobra      Mar 2021                     singularity(1)