create

limactl create

Create an instance of Lima

limactl create FILE.yaml|URL [flags]

Examples


To create an instance "default" from the default Ubuntu template:
$ limactl create

To create an instance "default" from a template "docker":
$ limactl create --name=default template://docker

To create an instance "default" with modified parameters:
$ limactl create --cpus=2 --memory=2

To create an instance "default" with yq expressions:
$ limactl create --set='.cpus = 2 | .memory = "2GiB"'

To see the template list:
$ limactl create --list-templates

To create an instance "default" from a local file:
$ limactl create --name=default /usr/local/share/lima/templates/fedora.yaml

To create an instance "default" from a remote URL (use carefully, with a trustable source):
$ limactl create --name=default https://raw.githubusercontent.com/lima-vm/lima/master/examples/alpine.yaml

To create an instance "local" from a template passed to stdin (--name parameter is required):
$ cat template.yaml | limactl create --name=local -

Options

      --arch string         machine architecture (x86_64, aarch64, riscv64)
      --containerd string   containerd mode (user, system, user+system, none)
      --cpus int            number of CPUs
      --disk float32        disk size in GiB
      --dns ipSlice         specify custom DNS (disable host resolver) (default [])
  -h, --help                help for create
      --list-templates      list available templates and exit
      --memory float32      memory in GiB
      --mount strings       directories to mount, suffix ':w' for writable (Do not specify directories that overlap with the existing mounts)
      --mount-type string   mount type (reverse-sshfs, 9p, virtiofs)
      --mount-writable      make all mounts writable
      --name string         override the instance name
      --network strings     additional networks, e.g., "vzNAT" or "lima:shared" to assign vmnet IP
      --plain               plain mode. Disable mounts, port forwarding, containerd, etc.
      --rosetta             enable Rosetta (for vz instances)
      --set string          modify the template inplace, using yq syntax
      --video               enable video output (has negative performance impact for QEMU)
      --vm-type string      virtual machine type (qemu, vz)

Options inherited from parent commands

      --debug              debug mode
      --log-level string   Set the logging level [trace, debug, info, warn, error]
      --tty                Enable TUI interactions such as opening an editor. Defaults to true when stdout is a terminal. Set to false for automation.

SEE ALSO

  • limactl - Lima: Linux virtual machines