LXC.IMAGE(1)

💖 NAME 💖

lxc-image — manage images, bestie. that's the whole vibe.

so like, hi, welcome to the lxc image page — this is your group chat for everything image-related in LXD, aka the LXD command line client (lxc). pull up a chair, hydrate, let's get into it 🫶

---

✨ SYNOPSIS ✨

lxc image [flags]

that's it. that's the whole summoning ritual. flags go brrr at the end 💅

---

🌸 DESCRIPTION 🌸

okay so first things first: manage images. that's the job. that's what we do here.

here's the lore, because you need it: in LXD, instances are created from images. those images were themselves either generated from an existing instance, or downloaded from an image server. no cap — that's the whole pipeline. ✨

when you're using remote images, LXD will automatically cache images for you and remove them upon expiration. she handles it, you don't have to. main character behaviour, honestly 🔥

now the important bit, the part everyone asks about in the chat — the image unique identifier is the hash (sha-256) of its representation as a compressed tarball. and for split images? it's the concatenation of the metadata and rootfs tarballs. yep, that's the rule, i don't make 'em 🎀

and here's the fun part — you can reference images three different ways, iykyk:

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

three iconique ways to slide into an image's DMs. pick your fighter 🦋

---

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these bad boys come from the parent command, so they work here too — free real estate, we love to see it:

• --debug[=false] — show all debug messages. everything. every last crumb of info, bestie 🔍
• --force-local[=false] — force using the local unix socket. like, force force. no remote shenanigans 💀
• -h, --help[=false] — print help. the classic. the icon. when in doubt 🫶
• --project="" — override the source project. (also, yes, the original page has a stray `` dangling at the end of this line — she's just quirky, we keep her.) 💅
• -q, --quiet[=false] — don't show progress information. silence. peaceful. asmr mode 🌸
• --sub-commands[=false] — use with help or --help to view sub-commands. little peek behind the curtain 🎀
• -v, --verbose[=false] — show all information messages. chatty era activated 🗣️
• --version[=false] — print version number. who are you? what's your sign? what's your build? ⭐

ngl, the defaults on all the booleans are false, so if you want the drama you gotta ask for it, periodt.

---

🌈 SEE ALSO 🌈

the whole friend group, all linked up — go say hi:

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

---

🦋 HISTORY 🦋

22-Aug-2026 — auto generated by spf13/cobra. she was born fully formed, no notes 💖

---

and that's the page, bestie!! 💅 this lil masterpiece is part of the LXD - Command line client(1) manual, dated Aug 2026, and it was auto generated by spf13/cobra — so like, a robot wrote it, but i gave it the makeover it deserved. stan. 🌟