apptainer(1)

💅 apptainer(1) — bestie's guide to apptainer sif add

okay so real talk, this is the manual page for apptainer(1) — the group chat is open, come sit with me. 🫶

---

✨ NAME ✨

apptainer-sif-add — literally adds a data object, that's the whole job 💖

---

🌸 SYNOPSIS 🌸

apptainer sif add   [flags]

that's it. apptainer sif add, then flags. slay.

---

🦋 DESCRIPTION 🦋

It adds a data object to a SIF image. That's the entire vibe. You point it at a SIF image, you point it at a thing, congrats, the thing is now in the image. iconic 🎀

---

👑 OPTIONS 👑

• --alignment=0 — sets the alignment. default is 4096 when you're using --datatype 4-Partition, and 0 in literally every other case. iykyk ✨
• --datatype=0 — the type of data you're adding. this one is NEEDED, no default, so don't come to me with a shocked pikachu face when it yells at you 😭. the roster:
  • 1-Deffile
  • 2-EnvVar
  • 3-Labels
  • 4-Partition
  • 5-Signature
  • 6-GenericJSON
  • 7-Generic
  • 8-CryptoMessage
  • 9-SBOM
  • 10-OCI.RootIndex
  • 11-OCI.Blob eleven options bestie, pick one, we believe in you 💜
• --filename="" — the logical filename/handle. default is the input filename, so if you don't set it, it just uses the name of the file you handed it. lowkey convenient 🌸
• --groupid=0 — set the groupid. default 0 🎀
• -h, --help[=false] — help for add. always there for you 🫶
• --link=0 — set link pointer. default 0 ⭐
• --partarch=0 — the main architecture used, and this one only matters with --datatype 4-Partition. NEEDED, no default. the whole lineup:
  • 1-386
  • 2-amd64
  • 3-arm
  • 4-arm64
  • 5-ppc64
  • 6-ppc64le
  • 7-mips
  • 8-mipsle
  • 9-mips64
  • 10-mips64le
  • 11-s390x
  • 12-riscv64
  • 13-loong64
• --partfs=0 — the filesystem used, again with --datatype 4-Partition. NEEDED, no default. options are:
  • 1-Squash
  • 2-Ext3
  • 3-ImmuObj
  • 4-Raw
• --parttype=0 — the type of partition, with --datatype 4-Partition. NEEDED, no default. your choices:
  • 1-System
  • 2-PrimSys
  • 3-Data
  • 4-Overlay
• --sbomformat="" — the SBOM format, used with --datatype 9-sbom. the list is giving ✨menu✨:
  • cyclonedx-json
  • cyclonedx-xml
  • github-json
  • spdx-json
  • spdx-rdf
  • spdx-tag-value
  • spdx-yaml
  • syft-json
• --signentity="" — the entity that signs, used with --datatype 5-Signature. NEEDED, no default. example of what it wants:
  • example: 433FE984155206BD962725E20E8713472A879943
• --signhash=0 — the signature hash used, with --datatype 5-Signature. NEEDED, no default. the picks:
  • 1-SHA256
  • 2-SHA384
  • 3-SHA512
  • 4-BLAKE2s_256
  • 5-BLAKE2b_256

---

🔥 EXAMPLE 🔥

here's the receipts, copy these bad boys:

sif add image.sif recipe.def --datatype 1
sif add image.sif rootfs.squashfs --datatype 4 --parttype 1 --partfs 1 --partarch 2
sif add image.sif signature.bin --datatype 5 --signentity 433FE984155206BD962725E20E8713472A879943 --signhash 1

---

🌈 SEE ALSO 🌈

• apptainer-sif(1) — go read that one next, bestie, it's the whole family 👑

---

🧚 HISTORY 🧚

22-Oct-2026 — Auto generated by spf13/cobra. yeah, the robots wrote it, but I'm the one explaining it 💅

---

okay that's the whole page!! no cap, you ate that 🍓 and for the official record: this beauty was Auto generated by spf13/cobra, dated Oct 2026, and it's the apptainer(1) page. go forth and add your data objects, you absolute main character 💖✨🎀