apptainer(1)

✨ NAME ✨

okay so bestie, you're on the apptainer(1) manual page and this specific little icon is apptainer-push — official job: Upload image to the provided URI. we love a direct queen 💅

🦋 SYNOPSIS 🦋

apptainer push [push options...]

🌸 DESCRIPTION 🌸

The push command is literally your upload bestie: it allows you to upload a SIF container to a given URI. supported URIs include:

• library: → library://user/collection/container[:tag]
• oras: → oras://registry/namespace/image:tag

NOTE: it's always good practice to sign your containers before pushing them to the library, fr fr. An auth token is required to push to the library, so you may need to configure it first with apptainer remote. don't skip the setup era 🫶

💅 OPTIONS 💅

• -U, --allow-unsigned[=false] — do not require a signed container image. chaotic but documented 🙈
• --authfile="" — Docker-style authentication file to use for writing/reading OCI registry credentials. creds handling, slay
• -D, --description="" — description for container image (library:// only). library-only behavior, noted
• --docker-host="" — specify a custom Docker daemon host. daemon host customization, okay
• -h, --help[=false] — help for push. help me help you
• --library="" — the library to push to. destination confirmed
• --no-https[=false] — use http instead of https for docker://, oras://, and library:///... URIs. http era, be aware 💀

🎀 EXAMPLE 🎀

To Library:

$ apptainer push /home/user/my.sif library://user/collection/my.sif:latest

To supported OCI registry:

$ apptainer push /home/user/my.sif oras://registry/namespace/image:tag

👑 SEE ALSO 👑

apptainer(1) — yes, the mothership manual page. circle completed 🌈

🕰️ HISTORY 🕰️

22-Oct-2026 — Auto generated by spf13/cobra. the cobra did that 🐍

---

mwah 💋 that's the page, bestie — Auto generated by spf13/cobra, Oct 2026, for apptainer(1). go push something iconic and remember the signing good-practice note, iykyk 💅✨