apptainer(1)                                                      apptainer(1)



NAME
       apptainer-pull - Pull an image from a URI



SYNOPSIS
       apptainer pull [pull options...] [output file]



DESCRIPTION
       The 'pull' command allows you to download or build a container from a
       given
         URI. Supported URIs include:


       library: Pull an image from the currently configured library
             library://user/collection/container[:tag]


       docker: Pull a Docker/OCI image from Docker Hub, or another OCI
       registry.
             docker://user/image:tag


       shub: Pull an image from Singularity Hub
             shub://user/image:tag


       oras: Pull a SIF image from an OCI registry that supports ORAS.
             oras://registry/namespace/image:tag


       ipfs: Pull a SIF image from an IPFS cluster, using a HTTP gateway.
             ipfs://cid


       http, https: Pull an image using the http(s?) protocol
             https://example.com/alpine.sif



OPTIONS
       --arch="amd64"      architecture to pull from library


       --arch-variant=""   architecture variant to pull from library


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


       --dir=""  download images to the specific directory


       --disable-cache[=false]  do not use or create cached images/blobs


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


       --docker-login[=false]   login to a Docker Repository interactively


       -F, --force[=false]      overwrite an image file if it exists


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


       --library=""   download images from the provided library


       --no-cleanup[=false]     do NOT clean up bundle after failed build, can
       be helpful for debugging


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


       --reproducible[=false]   creates a reproducible build by using the
       creation date of the source image


       --sandbox[=false]   pull image as sandbox format (chroot directory
       structure)



EXAMPLE

         From a library
         $ apptainer pull alpine.sif library://alpine:latest

         From Docker
         $ apptainer pull tensorflow.sif docker://tensorflow/tensorflow:latest
         $ apptainer pull --arch arm --arch-variant 6 alpine.sif docker://alpine:latest

         From Shub
         $ apptainer pull apptainer-images.sif shub://vsoch/apptainer-images

         From supporting OCI registry (e.g. Azure Container Registry)
         $ apptainer pull image.sif oras://<username>.azurecr.io/namespace/image:tag

         From available IPFS cluster (using a local HTTP IPFS gateway)
         $ apptainer pull lolcow.sif ipfs://bafybeice667c6gxovimsb6gnk6vex7vhzluhkl5hjv4ac4lhilxn52c43m



SEE ALSO
       apptainer(1)



HISTORY
       30-Jul-2026 Auto generated by spf13/cobra

Auto generated by spf13/cobra      Jul 2026                       apptainer(1)