apptainer-registry - Man Page
Manage authentication to OCI/Docker registries
Examples (TL;DR)
- List all configured registry credentials:
apptainer registry list - Log in to a registry with a username (password will be prompted):
apptainer registry login [-u|--username] username docker://registry - Log in to a custom OCI registry:
apptainer registry login [-u|--username] username oras://registry - Log in with username and password:
apptainer registry login [-u|--username] username [-p|--password] password docker://registry - Log in with a password from
stdin:echo "password" | apptainer registry login [-u|--username] username --password-stdin docker://registry - Log in using a custom authentication file:
apptainer registry login --authfile path/to/auth.json [-u|--username] username docker://registry - Log out from a registry:
apptainer registry logout docker://registry - Log out using a custom authentication file:
apptainer registry logout --authfile path/to/auth.json docker://registry
Synopsis
apptainer registry [subcommand options...]
Description
The 'registry' command allows you to manage authentication to standalone OCI/Docker
registries, such as 'docker://'' or 'oras://'.
Options
-c, --config="/builddir/.apptainer/remote.yaml" path to the file holding registry configurations
-h, --help[=false] help for registry
Example
All group commands have their own help output:
$ apptainer help registry login
$ apptainer registry loginSee Also
apptainer(1), apptainer-registry-list(1), apptainer-registry-login(1), apptainer-registry-logout(1)
History
12-Mar-2026 Auto generated by spf13/cobra
Referenced By
apptainer(1), apptainer-registry-list(1), apptainer-registry-login(1), apptainer-registry-logout(1).
Mar 2026 Auto generated by spf13/cobra