buildah-pull(1)             General Commands Manual            buildah-pull(1)

<?><?><?> (NAME)
       buildah-pull - <?><?><?><?><?><?> (pull) <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?>.


<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       buildah pull [options] image


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> containers-transports(5) <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> (<?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?>). <?><?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> (<?><?> containers-
       registries.conf(5) <?><?><?><?><?><?> <?><?><?><?>) <?> <?><?>
       <?><?><?> <?><?><?><?><?><?> docker (<?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>) <?><?><?><?><?><?><?> <?><?><?><?><?><?>.


   <?><?><?><?><?><?><?><?><?><?> (DEPENDENCIES)
       <?><?><?><?><?> Buildah <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       /etc/containers/registries.conf <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> containers-registries.conf(5)
       <?><?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?><?><?> buildah pull
       <?><?> <?><?><?><?> "image not known" <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       registries.conf <?><?><?> <?><?><?> <?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>.


<?><?><?><?><?> <?><?><?><?><?><?><?> (RETURN VALUE)
       <?><?><?><?><?> <?><?><?><?><?> (image ID) <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> 1 <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.


<?><?><?><?><?><?><?><?> (OPTIONS)
       --all-tags, -a


       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>.


       --arch="ARCH"


       <?><?><?><?><?> <?><?><?><?><?><?> (ARCH) <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.
       (<?><?><?><?><?><?><?><?>: arm, arm64, 386, amd64, ppc64le, s390x)


       --authfile path


       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?> ${XDG_RUNTIME_DIR}/containers/auth.json
       <?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       containers-auth.json(5) <?><?> <?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> buildah login
       <?><?><?><?><?> <?><?><?><?><?><?>.


       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       $HOME/.docker/config.json <?><?> <?><?> docker login <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.


       <?><?><?><?>: <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> REGISTRY_AUTH_FILE <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>: export
       REGISTRY_AUTH_FILE=path


       --cert-dir path


       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> path (*.crt, *.cert, *.key) <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>.
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> /etc/containers/certs.d <?><?><?>.


       --creds creds


       <?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
       [username[:password]] <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> (<?><?> <?><?><?><?> <?><?><?><?>). <?><?><?>
       <?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.


       --decryption-key key[:passphrase]


       <?><?><?><?> [key[:passphrase]] <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?>/<?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?>. <?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>.


       --os="OS"


       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> (OS) <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.


       --platform="OS/ARCH[/VARIANT]"


       <?><?><?><?><?> <?><?><?><?><?><?><?> OS/ARCH <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?>
       linux/arm).


       <?><?><?><?><?><?><?> OS/ARCH <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> Go
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> ARCH <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> arch <?><?><?><?><?> <?><?><?><?>.
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> $GOOS <?> $GOARCH <?><?>
       https://golang.org/doc/install/source#environment <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> go tool dist list <?><?><?><?><?> <?><?>
       <?><?><?><?>.


       <?><?><?><?>: <?><?><?><?><?> --platform <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> --arch<?> --os
       <?><?> --variant <?><?><?><?><?><?><?> <?><?><?>.


       --policy=always|missing|never|newer


       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>.
       <?><?><?><?><?><?><?> missing <?><?><?>.


              o always: <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
                <?><?><?><?><?><?> <?><?> <?> <?><?> <?><?><?><?> <?><?><?><?>
                <?><?><?> <?><?><?><?> <?><?>.

              o missing: <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
                <?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
                <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
                <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.
                <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?>
                <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
                <?><?><?><?> <?><?><?> <?><?><?><?> <?><?>.

              o never: <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
                <?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
                <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
                <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
                <?><?>. <?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
                <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?>.

              o newer: <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
                <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
                <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
                <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
                <?><?> <?><?> <?><?><?><?><?><?> <?><?>. <?><?>
                <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
                <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
                <?><?><?><?><?><?><?><?><?> <?><?> (digests)
                <?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?><?>
                <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
                <?><?><?><?><?>. <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
                <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
                <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
                <?><?><?><?><?><?><?>.



       --quiet, -q


       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?>.


       --remove-signatures


       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?>.


       --retry attempts


       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>.


       <?><?><?><?><?><?><?> 3 <?><?><?>.


       --retry-delay duration


       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?>.


       <?><?><?><?><?><?><?> 2s <?><?><?>.


       --tls-verify bool-value


       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> HTTPS <?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> (<?><?><?><?><?><?><?> true <?><?><?>).
       <?><?><?><?><?><?><?><?><?><?> TLS <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> (insecure)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.


       --variant=""


       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> (architecture variant)
       <?><?><?><?><?> <?><?><?><?><?><?><?>.


<?><?><?><?><?><?><?> (EXAMPLE)
       buildah pull imagename


       buildah pull docker://myregistry.example.com/imagename


       buildah pull docker-daemon:imagename:imagetag


       buildah pull docker-archive:filename


       buildah pull oci-archive:filename


       buildah pull dir:directoryname


       buildah pull --tls-verify=false
       myregistry/myrepository/imagename:imagetag


       buildah pull --creds=myusername:mypassword --cert-dir ~/auth
       myregistry/myrepository/imagename:imagetag


       buildah pull --authfile=/tmp/auths/myauths.json
       myregistry/myrepository/imagename:imagetag


       buildah pull --arch=aarch64 myregistry/myrepository/imagename:imagetag


       buildah pull --arch=arm --variant=v7
       myregistry/myrepository/imagename:imagetag


<?><?><?><?> (ENVIRONMENT)
       BUILD_REGISTRY_SOURCES


       <?><?><?><?><?> BUILD_REGISTRY_SOURCES <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?> JSON <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       insecureRegistries<?> blockedRegistries <?> allowedRegistries
       <?><?><?>.


       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> blockedRegistries <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?>. <?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       allowedRegistries <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?>.


       TMPDIR <?><?><?><?><?> <?><?><?><?><?> TMPDIR <?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?><?>
       '/var/tmp' <?><?><?>.


<?><?><?><?><?><?><?><?><?> (FILES)
       registries.conf (/etc/containers/registries.conf)


       <?><?><?><?><?><?> registries.conf <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?>.


       policy.json (/etc/containers/policy.json)


       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>. <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?>.


<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       buildah(1), buildah-from(1), buildah-login(1), docker-login(1),
       containers-policy.json(5), containers-registries.conf(5), containers-
       transports(5), containers-auth.json(5)

buildah                            July 2018                   buildah-pull(1)