INCUS.IMAGE(1)

💖 incus-image — Manage images 💖

okay bestie, welcome to incus-image, part of the incus command line client family. she manages images, and she EATS. let's get into it 🫶

---

✨ SYNOPSIS ✨

incus image [flags]

---

🌸 DESCRIPTION 🌸

Description: Manage images 💅

so here's the tea: instances are created from images. and those images? they were themselves either generated from an existing instance or downloaded from an image server. that's the whole pipeline, no cap ✨

when you're using remote images, the server will automatically cache images for you and remove them upon expiration. it's giving "i got you, bestie" 🧚

the image's unique identifier is the hash (sha-256) of its representation as a compressed tarball — or, for split images, the concatenation of the metadata and rootfs tarballs. so like, the ID is the content. main character energy fr fr 👑

and you can reference images three ways:

• their full hash
• the shortest unique partial hash
• an alias name (if one is set)

pick your fighter, they all slay 🌈

---

💀 OPTIONS INHERITED FROM PARENT COMMANDS 💀

these ones come from the parent command, but they're still iconic:

• --debug[=false] — show all debug messages. every single one. yes, all of them 🙈
• --explain[=false] — if the command is valid, explain its parsed arguments instead of running it. she'll describe the fit instead of wearing it ✨
• --force-local[=false] — force using the local unix socket 🔌
• -h, --help[=false] — print help 🆘
• --project="" — override the source project`` (yes bestie, those are the actual characters in the source, we don't edit the canon) 🎀
• -q, --quiet[=false] — don't show progress information. silent but deadly, lowkey 🤫
• --sub-commands[=false] — use with help or --help to view sub-commands 🦋
• -v, --verbose[=false] — show all information messages. she's a yapper and we love her for it 💜
• --version[=false] — print version number ⭐

---

👑 SEE ALSO 👑

the whole friend group, go say hi:

incus(1), incus-image-alias(1), incus-image-copy(1), incus-image-delete(1), incus-image-edit(1), incus-image-export(1), incus-image-generate-metadata(1), incus-image-get-property(1), incus-image-import(1), incus-image-info(1), incus-image-list(1), incus-image-refresh(1), incus-image-set-property(1), incus-image-show(1), incus-image-unset-property(1)

---

📜 HISTORY 📜

24-Sep-2026 — auto generated by spf13/cobra 🌸

---

and that's the whole page! auto generated by spf13/cobra, dated Sep 2026, from the Incus - Command line client(1) manual. periodt. 💅✨