OCI-IMAGE-TOOL-UNPACK(1)(OCI)

👑 oci-image-tool unpack — the manual page, but make it slay

okay bestie, welcome to the oci-image-tool unpack page from the OCI manual, section OCI, dated JULY 2016. sit down, hydrate, we're unpacking some layers 💅

---

✨ NAME ✨

oci-image-tool unpack — unpack an image or image source layout 🎀

---

🌸 SYNOPSIS 🌸

oci-image-tool unpack [src] [dest] [OPTIONS]

---

🦋 DESCRIPTION 🦋

so what does this lil icon actually do? oci-image-tool unpack validates an application/vnd.oci.image.manifest.v1+json and then unpacks its layered filesystem to dest. that's it. that's the whole vibe. it checks the manifest is valid, then spills the layers out into your destination folder. main character behaviour honestly ✨

---

💖 OPTIONS 💖

• --help — prints the usage statement. the classic. when in doubt, ask for help, no shame 🫶
• --ref=[] — sets the search criteria for the validated reference. the format is A=B. the reference should point to a manifest or an index. for example: --ref name=v1.0 --ref platform.os=latest. it only supports three cases: name, platform.os, and digest. those three. that's the list. don't try to freestyle a fourth one 🙈
• --type="" — the type of file to unpack. if you leave it unset, oci-image-tool will try to auto-detect the type for you (so thoughtful of it 💅). it's one of "imageLayout,image,imageZip".
• --platform="" — specifies the os and architecture of the manifest, format is OS:Architecture. e.g. --platform linux:amd64. heads up: this one is only applicable if the reftype is an index. if it's not an index, this option is just standing there looking pretty for no reason 😭

---

🌈 EXAMPLES 🌈

here's the whole little journey, step by step, look how cute:

$ skopeo copy docker://busybox oci:busybox-oci:latest
$ mkdir busybox-bundle
$ oci-image-tool unpack --ref name=latest busybox-oci busybox-bundle
$ tree busybox-bundle
busybox-bundle
├── bin
│   ├── [
│   ├── [[
│   ├── acpid
│   ├── addgroup
│   ├── add-shell
│   ├── adduser
│   ├── adjtimex
│   ├── ar
│   ├── arp
│   ├── arping
│   ├── ash
[...]

the [...] is doing a lot of heavy lifting there but honestly? respect. we don't need the full busybox manifest of a directory listing, we got the point, we ate 🍓

---

🧚 SEE ALSO 🧚

• skopeo(1) — go say hi to its sibling, they're a whole duo 👑

---

💜 HISTORY 💜

Sept 2016 — originally compiled by Antonio Murdaca (runcom at redhat dot com). legend behaviour, we love a credited author 🎀

---

⭐ tiny note, bestie: this page is from the OCI-IMAGE-TOOL-UNPACK(1)(OCI) manual, Tool / Image section, and the whole thing is dated July 2016. periodt. go unpack something iconic 💅✨🦋