---
name: "incus.launch"
section: "1"
platform: "linux"
package: "incus-client"
version: "6.0.4-2+deb13u10"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/incus.launch"
---

# incus.launch(1)

Create and start instances from images

## NAME

incus-launch - Create and start instances from images

## SYNOPSIS

**incus launch \[:\] \[:\]\[\] \[flags\]**

## DESCRIPTION

Description:\
   Create and start instances from images

## OPTIONS

**-c**, **--config**=\[\]\
 	Config key/value to apply to the new instance\`\`

**--console**\[=""\]\
 	Immediately attach to the console\`\`

**--description**=""\
 	Instance description\`\`

**-d**, **--device**=\[\]\
 	New key/value to apply to a specific device\`\`

**--empty**\[=false\]\
 	Create an empty instance

**--environment-file**=""\
 	Include environment variables from file\`\`

**-e**, **--ephemeral**\[=false\]\
 	Ephemeral instance

**-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

**--debug**\[=false\]\
 	Show all debug messages

**--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 launch images:ubuntu/22.04 u1
  incus launch images:ubuntu/22.04 u1 < config.yaml
      Create and start a container with configuration from config.yaml
  incus launch images:ubuntu/22.04 u2 -t aws:t2.micro
      Create and start a container using the same size as an AWS t2.micro (1 vCPU, 1GiB of RAM)
  incus launch images:ubuntu/22.04 v1 --vm -c limits.cpu=4 -c limits.memory=4GiB
      Create and start a virtual machine with 4 vCPUs and 4GiB of RAM
  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
```

## SEE ALSO

**[incus(1)](/incus/1.md)**

## HISTORY

2-Sep-2026 Auto generated by spf13/cobra