apptainer(1)

💖 apptainer(1) — the remote one 💖

okay so real talk, this is a page out of the apptainer manual (that's the manual name, bestie, we're in the big apptainer(1) book 📖), and today's episode is all about apptainer-remote. yes girl, remote endpoints. it's giving cloud era ✨

🌸 NAME 🌸

apptainer-remote — manage apptainer remote endpoints 🫶

🦋 SYNOPSIS 🦋

apptainer remote [remote options...]

✨ DESCRIPTION ✨

The remote command lets you manage Apptainer remote endpoints — and it does that through its subcommands, so the main character here is really the subcommand squad 👑.

so, what even is a remote endpoint? bestie it's a group of services that is compatible with the container library API. like, it's a single address — think cloud.example.com — and through that one address the library and/or keystore services get automatically discovered. one door, whole house behind it, slay 🚪✨

to configure a remote endpoint you gotta remote add it first. you can remote login if you're gonna be doing actions that need authentication (iykyk 🔐). switch between your configured remote endpoints with the remote use command. whichever one is active is the one that gets used for key operations, and for library:// pull and push. you can also remote logout from an endpoint and remote remove one that's no longer required — like unfollowing, but for infrastructure 💅

ngl the remote configuration lives in $HOME/.apptainer/remotes.yaml by default. that's the default, fr fr.

🎀 OPTIONS 🎀

• -c, --config="/builddir/.apptainer/remote.yaml" — path to the file holding remote endpoint configurations 📁
• -h, --help[=false] — help for remote (yes she has her own help, periodt)

💜 EXAMPLE 💜

all group commands have their own help output, so go peek:

$ apptainer help remote list
$ apptainer remote list

🌈 SEE ALSO 🌈

apptainer(1), apptainer-remote-add(1), apptainer-remote-get-login-password(1), apptainer-remote-list(1), apptainer-remote-login(1), apptainer-remote-logout(1), apptainer-remote-remove(1), apptainer-remote-status(1), apptainer-remote-use(1) — the whole friend group 🫶

⭐ HISTORY ⭐

22-Oct-2026 — auto generated by spf13/cobra 🤖 (not me writing manpages by hand, couldn't be me)

---

🍓 aww and that's a wrap! this little page was auto generated by spf13/cobra, from way back in Oct 2026, and it's part of the apptainer(1) manual — ok bye bestie, go configure a remote endpoint, you got this 💖🧚‍♀️