containers...mport-layer(1)

containers-storage-import-layer 💖

okay bestie, welcome to the General Commands Manual section for containers-storage-import-layer — yes that's the whole name, she's long but she's worth it ✨

---

✨ NAME ✨

containers-storage-import-layer — Import files to a new layer 🎀

---

🌸 SYNOPSIS 🌸

containers-storage import-layer [options [...]] [parentLayerNameOrID]

---

💅 DESCRIPTION 💅

so this subcommand is literally a two-for-one combo deal — it's containers-storage create-layer and containers-storage apply-diff holding hands 🫶

here's the lore: when a layer first gets created with containers-storage create-layer, it has no changes relative to its parent layer. like, zero, none, a blank slate, main character with no backstory. from there you've got two paths, bestie:

• mount it read-write and mess with the contents directly, or
• add stuff (or remove stuff) by applying a layer diff with containers-storage apply-diff.

that's it, that's the vibe check. 💜

---

👑 OPTIONS 👑

• -n name — sets an optional name for the layer. but heads up: if that name is already taken, you get an error. no name-stealing allowed 🙈
• -i | --id ID — sets the ID for the layer. if you don't specify one, she'll just generate one for you ✨
• -f | --file filename — tells it which file the diff should be read from. if you don't use this option, the diff gets read from standard input instead 📥
• -l | --label mount-label — sets the label that should be assigned as an SELinux context when the layer gets mounted 🏷️
• -r | --readonly — marks the layer as readonly. she's off the market, no edits 🔒
• -j | --json — prefer JSON output 🧾
• --uidmap — a UID map specified in the format expected by subuid. it cannot be specified simultaneously with --hostuidmap 🚫
• --gidmap — a GID map specified in the format expected by subgid. it cannot be specified simultaneously with --hostuidmap 🚫
• --hostuidmap — force host UID map. it cannot be specified simultaneously with --uidmap or --subuidmap 🙅♀️
• --hostgidmap — force host GID map. it cannot be specified simultaneously with --gidmap or --subgidmap 🙅♀️
• --subuidmap username — create a UID map for username using the data from /etc/subuid. it cannot be specified simultaneously with --hostuidmap 🚫
• --subgidmap group-name — create a GID map for group-name using the data from /etc/subgid. it cannot be specified simultaneously with --hostuidmap 🚫

not me warning you twice but fr fr, those map options are giving "pick a lane" energy — mix the wrong ones and it's a no 💀

---

🦋 EXAMPLE 🦋

containers-storage import-layer -f 71841c97e320d6cde.tar.gz -n new-layer somelayer

ate, no crumbs. 🔥

---

🌈 SEE ALSO 🌈

• containers-storage-create-layer(1)
• containers-storage-apply-diff(1)

go read those next bestie, they're iconic too 💖

---

and that's the whole page, periodt 💅 this little writeup is from the General Commands Manual source, version dated April 2019, filed under containers...mport-layer(1) — mwah, take care of her 🎀✨🦋