apptainer(1)

💅 apptainer(1) — the glow-up edition 🎀

okay so real talk, this is a page from the apptainer manual set, and bestie, this one is specifically about apptainer-oci-create — creating a container from a bundle directory. and yes, root user only. crown behavior 👑✨

---

✨ NAME ✨

apptainer-oci-create — create a container from a bundle directory (root user only, no exceptions, iykyk 🙈)

---

🦋 SYNOPSIS 🦋

apptainer oci create -b  [create options...]

that's it. that's the whole vibe check. -b goes in, options go in, you're so back 💅

---

🌸 DESCRIPTION 🌸

so what's actually happening here? Create invokes the create operation, which makes a container instance out of an OCI bundle directory. like, the bundle directory is the blueprint and this command is the main character bringing it to life, no cap ✨

fr fr that's the entire description. short, sweet, iconic.

---

🎀 OPTIONS 🎀

okay bestie, here's the full rundown — every single one, we are not skipping 🫶

• -b, --bundle="" — specify the OCI bundle path. this one is required, so like... do not forget it, it's giving "showed up to class without the assignment" 😭
• --empty-process[=false] — run the container without executing the container process (eg: for POD container). lowkey useful for that POD situation 💜
• -h, --help[=false] — help for create. the classic. the icon. when in doubt, ask for help 🌈
• --log-format="kubernetes" — specify the log file format. available formats are basic, kubernetes and json. pick your fighter ⭐
• -l, --log-path="" — specify the log file path. where the logs go live 📁
• --pid-file="" — specify the pid file. pid goes in, pid file goes out 🍓
• -s, --sync-socket="" — specify the path to unix socket for state synchronization. sockets, syncing, slay 🔥

---

💖 EXAMPLE 💖

here's the moment you've been waiting for, a real live example:

$ apptainer oci create -b ~/bundle mycontainer

look at that. -b ~/bundle for the bundle, mycontainer as the name. ate and left no crumbs 🧚✨

---

🔍 SEE ALSO 🔍

• apptainer-oci(1) — go read the parent page too bestie, it's giving whole picture 🦋

---

📜 HISTORY 📜

22-Oct-2026 — Auto generated by spf13/cobra. yes, a machine made it, and it still served 💅

---

⚠️ quick reminder: this whole thing is root user only. don't come crying to me if it says no — that's the vibe check failing, not the docs 🙈

---

so that's the page!! auto generated by spf13/cobra, dated Oct 2026, and it lives in the apptainer(1) manual — mwah, go create some containers 💜🎀✨