apptainer-pull

Pull a container from Docker Hub

$ apptainer pull [path/to/image.sif] docker://[image]:[tag]

$ apptainer pull [path/to/image.sif] library://[user/collection/container]:[tag]

$ apptainer pull [path/to/image.sif] oras://[registry/namespace/image]:[tag]

$ apptainer pull --arch [amd64|arm64|ppc64le] [path/to/image.sif] library://[image]:[tag]

$ apptainer pull -F [path/to/image.sif] docker://[image]:[tag]

$ apptainer pull --sandbox [path/to/directory] docker://[image]:[tag]

$ apptainer pull --disable-cache [path/to/image.sif] docker://[image]:[tag]

apptainer pull [options] image URI

apptainer pull downloads container images from remote registries and converts them to the SIF (Singularity Image Format). Supported sources include Docker Hub (docker://), the Sylabs Container Library (library://), OCI registries (oras://), and Shub (shub://).
Downloaded images are cached locally to speed up subsequent operations. The resulting SIF file is portable and can be run on any system with Apptainer installed.

--arch architecture

Pull image for a specific CPU architecture

Overwrite an existing local image file

Create a writable directory instead of a SIF file

Do not use or update the image cache

Use HTTP instead of HTTPS for downloads

/etc/apptainer/apptainer.conf

Main configuration file controlling cache directories, registry defaults, and download behavior.

Large images may take significant time and bandwidth to download. Docker images are converted on-the-fly which can add overhead. Some Docker images may not convert perfectly due to differences in runtime expectations.

apptainer(1), apptainer-push(1), apptainer-build(1)