---
name: "apptainer-pull"
section: "1"
platform: "linux"
package: "apptainer"
version: "1.5.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/apptainer-pull"
---

# apptainer-pull(1)

Pull an image from a URI

## 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)](/apptainer/1.md)**

## HISTORY

22-Sep-2026 Auto generated by spf13/cobra