incus launch - Incus documentation
Description: Create and start instances from images Synopsis: Description:, Create and start instances from images,,,, Examples: Options: Options inherited from parent commands: SEE ALSO: incus- Command line cl...

Skip to content
Back to top
View this page

# `incus launch`

Create and start instances from images

## Synopsis

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)

      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
          --console[="console"]   Immediately attach to the console
          --description           Instance description
      -d, --device                New key/value to apply to a specific device
          --empty                 Create an empty instance
          --environment-file      Include environment variables from file
      -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
      -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 - Command line client for Incus