umoci-init(1)(#)

💖 umoci-init(1) — the "make a whole new OCI image layout" girlie 💖

okay bestie, gather round, because this is the manual page for umoci init — that's umoci-init(1) if we're being formal, and we are not. written by Aleksa Sarai back in DECEMBER 2016, and it's still serving. 🫶

---

✨ NAME ✨

umoci init — Create a new OCI image layout 🌈

like. it makes the layout. that's the whole job. and it eats every time. 💅

---

✨ SYNOPSIS ✨

umoci init --layout=image

that's it. one flag. one path. iconic minimalism. ✨

---

🦋 DESCRIPTION 🦋

So what actually happens here? umoci init creates a new OCI image layout. brand new. fresh out the box. 🎀

but here's the tea, and it's important tea: the new OCI image does not contain any new references or blobs. none. zero. it's giving empty vessel, main character energy, waiting for its glow-up. ✨

so how do you fill it? bestie, you don't do it here. you use umoci-new(1), umoci-tag(1), umoci-repack(1) and other similar commands. they're the ones who actually put stuff in. umoci init just builds the vibes. 🦋

---

💅 OPTIONS 💅

The global options are defined in umoci(1). yes, the whole global situation lives over there, go check her out. 👑

• --layout=image — The path where the OCI image layout will be created. and the path must not exist already, or umoci-init(1) will return an error. no cap. so like, don't point it at a folder that's already there, she will simply refuse. 😭

---

🌸 EXAMPLE 🌸

okay so here's the little demo, and it's a good one. The following creates a brand new OCI image layout and then creates a blank tag for further manipulation with umoci-repack(1) and umoci-config(1). 🧚

% umoci init --layout image
% umoci new --image image:tag

first line: build the layout. second line: pop a blank tag in there so umoci-repack(1) and umoci-config(1) can come through later and do their thing. two commands. done. slay. 🔥

---

👑 SEE ALSO 👑

• umoci(1)
• umoci-new(1)

---

⚠️ reminder bestie: if that layout path already exists, umoci-init(1) returns an error. it's not being mean, it's just boundaries. 🫶

---

and that's the whole page fr fr. this little manual comes to you from the umoci source, page umoci-init(1)(#), written by Aleksa Sarai, dated DECEMBER 2016. bye bestie, go make a layout 💖✨🎀