apptainer(1)

💅 apptainer(1) — bestie's guide to apptainer instance stats

okay so this is a page from the apptainer manual, and today's main character is apptainer-instance-stats. yes it's a mouthful. no we're not changing it. let's go 🎀

---

✨ NAME ✨

apptainer-instance-stats — get stats for a named instance 🧚

like, the numbers. the tea. the vitals. for an instance that has a name.

---

🌸 SYNOPSIS 🌸

apptainer instance stats [stats options...]

that's it. that's the whole vibe check. you point it at the stats subcommand and then you sprinkle options on top like glitter ✨

---

🦋 DESCRIPTION 🦋

so the instance stats command is literally your personal detective for a named instance 🕵️‍♀️ it lets you get statistics for that instance — and it'll either print them right to the terminal or hand them over in json. your choice, bestie, both are iconic.

if you're root, you can optionally ask for statistics for a container instance that belongs to a specific user 👑 (yes, root gets extra powers, we know, we know).

and if you add --no-stream, you only get one timepoint — one lil snapshot, no live feed, no "wait what happened next". asking for json implies the exact same thing, so json mode is also just the one timepoint. no cap.

---

💅 OPTIONS 💅

• -h, --help[=false] — help for stats 🫶 the classic. when in doubt, ask for help.
• -j, --json[=false] — output stats in json 📦 machine-readable, structured, delicious.
• --no-stream[=false] — disable streaming (live update) of instance stats ⏸️ so you get a single timepoint instead of the live glow-up.
• -u, --user="" — view stats for an instance belonging to a user (root only) 👑 default is "", and yeah, root only. don't try it as a regular user, it's not gonna slay.

---

🔥 EXAMPLE 🔥

$ apptainer instance stats mysql
$ apptainer instance stats --json mysql
$ apptainer instance stats --no-stream mysql
$ sudo apptainer instance stats --user <username> user-mysql

see how the last one has sudo? that's the root-only --user one. the <username> is a placeholder, babes, swap in a real one 💖

---

🌈 SEE ALSO 🌈

• apptainer-instance(1) — the parent page. go say hi, it has the whole instance family tree 🌳

---

⭐ HISTORY ⭐

22-Oct-2026 — Auto generated by spf13/cobra 🤖 yes, a robot wrote this. and honestly? it ate.

---

and that's the whole page, bestie — every flag, every default, every example, nothing skipped, nothing invented 💜

this lil number was Auto generated by spf13/cobra, dated Oct 2026, and it lives happily inside apptainer(1) — mwah 💋 catch you in the next manpage! 🎀