umoci-new(1)(#)

💖 umoci-new(1)(#) — the glow-up era 💖

okay bestie, so this is umoci-new(1), and it's literally the "start from a blank canvas" button for OCI images. written by Aleksa Sarai, back in DECEMBER 2016 (an icon, honestly). let's get into it 🫶

---

✨ NAME ✨

umoci new — create a blank tag in an OCI image 🌱

---

🌸 SYNOPSIS 🌸

umoci new --image=image[:tag]

that's it. that's the whole vibe. one command, one flag, infinite possibilities 💅

---

🦋 DESCRIPTION 🦋

so here's the tea: umoci new creates a blank tag inside an OCI image. the created image's configuration and manifest are both set to umoci-defined default values, and there are no filesystem layer blobs added to the image at all. like, none. zero. an empty little baby image, freshly born 🎀

once a new image is created with umoci-new(1), you can go straight in and use it with umoci-unpack(1), umoci-repack(1), and umoci-config(1) to modify that new tagged image however you see fit. no gatekeeping, no prerequisites ✨

and the reason this is iconic? it lets you create entirely new images from scratch, with no base image needed to start from. main character energy fr fr 👑

---

💜 OPTIONS 💜

the global options are defined over in umoci(1) — go check that one out, bestie.

• --image=image[:tag] — this is the destination of the blank tag in the OCI image. image must be a path to a valid OCI image, and tag must be a valid tag name. if a tag already exists with the name tag, it will be overwritten 💀 (yes, really — no warning, it just goes). and if tag isn't provided at all, it defaults to "latest". periodt.

---

🌈 EXAMPLE 🌈

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). look at her go:

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

---

⭐ SEE ALSO ⭐

umoci(1), umoci-unpack(1), umoci-repack(1), umoci-config(1)

the whole friend group, honestly 🫶

---

and that's the page!! sourced from new, version umoci, living under the manual name umoci-new(1)(#) 🌸 go forth and make a blank tag, you've got this, no cap 💖✨🎀