lxc launch

Create and start instances from images

Synopsis

Description: Create and start instances from images

If the destination LXD remote supports image registries, the source image must be from an image registry or available locally on the destination remote.

lxc launch [<registry|remote>:]<image> [<remote>:][<name>] [flags]

Examples

  lxc launch ubuntu:24.04 u1
      Create and start a container

  lxc launch ubuntu:24.04 u1 < config.yaml
      Create and start a container with configuration from config.yaml

  lxc launch ubuntu:24.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)

  lxc launch ubuntu:24.04 v1 --vm -c limits.cpu=4 -c limits.memory=4GiB
      Create and start a virtual machine with 4 vCPUs and 4GiB of RAM

  lxc launch ubuntu:24.04 v1 --vm -c limits.cpu=2 -c limits.memory=8GiB -d root,size=32GiB
      Create and start a virtual machine with 2 vCPUs, 8GiB of RAM and a root disk of 32GiB

Options

  -c, --config                Config key/value to apply to the new instance
      --console[="console"]   Immediately attach to the console
  -d, --device                New key/value to apply to a specific device
      --empty                 Create an empty instance
  -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
      --target-project        Project to create the instance in (if different from --project)
  -t, --type                  Instance type
      --vm                    Create a virtual machine

Options inherited from parent commands

      --debug          Show all debug messages
      --force-local    Force using the local unix socket
  -h, --help           Print help
      --project        Override the source project
  -q, --quiet          Do not 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

• lxc - Command line client for LXD