(incus_launch.md)=
# `incus launch`

Create and start instances from images

## Synopsis
```{line-block}

Description:
  Create and start instances from images



```
```
incus launch (--empty|[<remote>:]<image>) [<remote>:][<new instance name>] [flags]
```

## Examples

```
  incus launch images:debian/12 c1
      Create and start a container named "c1"

  incus launch images:debian/12 c2 < config.yaml
      Create and start a container named "c2" with configuration from config.yaml

  incus launch images:debian/12 c3 -t aws:t2.micro
      Create and start a container named "c3" using the same size as an AWS t2.micro (1 vCPU, 1GiB of RAM)
      Find the list of supported instance types here: https://images.linuxcontainers.org/meta/instance-types/

  incus launch images:debian/12 v1 --vm -c limits.cpu=4 -c limits.memory=4GiB
      Create and start a virtual machine named "v1" 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 named "v2", overriding the disk size and bus
```

## Options

```
  -c, --config                Config key/value to apply to the new instance (may be passed multiple times)
      --console[="console"]   Immediately attach to the console
      --description           Instance description
  -d, --device                New key/value to apply to a specific device (may be passed multiple times)
      --empty                 Create an empty instance
      --environment-file      Include environment variables from file (may be passed multiple times)
  -e, --ephemeral             Ephemeral instance
  -n, --network               Network name
      --no-profiles           Create the instance with no profiles applied
  -p, --profile               Profile to apply to the new instance (may be passed multiple times)
  -s, --storage               Storage pool name
      --target                Cluster member name
  -t, --type                  Instance type
      --vm                    Create a virtual machine
```

## Options inherited from parent commands

```
      --debug          Show all debug messages
      --explain        If the command is valid, explain its parsed arguments instead of running it
      --force-local    Force using the local unix socket
  -h, --help           Print help
      --project        Override the source project
  -q, --quiet          Don't show progress information
      --sub-commands   Use with help or --help to view sub-commands
  -v, --verbose        Show all information messages
      --version        Print version number
```

## SEE ALSO

* [incus](incus.md)	 - Command line client for Incus

