INCUS.CREATE(1)

📦
version 7.0.1 · 11 versions
, in ubuntu stonking

💖 NAME 💖

okay bestie, gather round — incus-create is the one that creates instances from images ✨ it's literally the "build me a whole new baby instance" command, no cap.

this page lives in the Incus - Command line client(1) manual, and yes we are about to read the whole thing together 🫶

🌸 SYNOPSIS 🌸

incus create (--empty|[:]) [:][] [flags]

that's the vibe check. short, iconic, does exactly what it says 💅

🦋 DESCRIPTION 🦋

Description:

  • Create instances from images

that's it, that's the whole thing — you point it at an image and it spins you up a fresh instance. main character energy fr fr 🔥

✨ OPTIONS ✨

  • -c, --config=[] — config key/value to apply to the new instance 💜
  • --description="" — a lil description for your instance 🎀
  • -d, --device=[] — new key/value to apply to a specific device 👑
  • --empty[=false] — create an empty instance (no image, just vibes) 🫶
  • --environment-file="" — include environment variables from a file 🌈
  • -e, --ephemeral[=false] — ephemeral instance — it's giving "here for a good time, not a long time" 💀
  • -n, --network="" — network name 🌐
  • --no-profiles[=false] — create the instance with no profiles applied 🙈
  • -p, --profile=[] — profile to apply to the new instance ⭐
  • -s, --storage="" — storage pool name 🍓
  • --target="" — cluster member name 🧚
  • -t, --type="" — instance type ✨
  • --vm[=false] — create a virtual machine 🔥

💅 OPTIONS INHERITED FROM PARENT COMMANDS 💅

these ones come from the big parent command, they're the family heirlooms:

  • --debug[=false] — show all debug messages 🐛
  • --explain[=false] — if the command is valid, explain its parsed arguments instead of running it 👀
  • --force-local[=false] — force using the local unix socket 🔌
  • -h, --help[=false] — print help 🫶
  • --project="" — override the source project 🎯
  • -q, --quiet[=false] — don't show progress information 🤫
  • --sub-commands[=false] — use with help or --help to view sub-commands 🌿
  • -v, --verbose[=false] — show all information messages 📢
  • --version[=false] — print version number 🏷️

🌈 EXAMPLE 🌈

  incus create images:debian/12 u1
      Create the instance u1

  incus create images:debian/12 u1 < config.yaml
      Create the instance with configuration from config.yaml

  incus launch images:debian/12 v2 --vm -d root,size=50GiB -d root,io.bus=nvme
      Create and start a virtual machine, overriding the disk size and bus

look at those three. obsessed. the third one is lowkey the flex — VM + custom disk size + custom bus, all in one line 😭✨

👑 SEE ALSO 👑

go read that one next bestie, it's the mothership 🚀

📜 HISTORY 📜

24-Sep-2026 Auto generated by spf13/cobra

okay that's the whole page!! this one was Auto generated by spf13/cobra, dated Sep 2026, and it's part of the Incus - Command line client(1) manual 💖 go create something iconic, you got this 🎀🦋✨

📦 where this page comes from