limactl start

Start an instance of Lima

limactl start NAME|FILE.yaml|URL [flags]


To create an instance "default" (if not created yet) from the default Ubuntu template, and start it:
$ limactl start

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

'limactl start' also accepts the 'limactl create' flags such as '--set'.
See the examples in 'limactl create --help'.


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


  • limactl - Lima: Linux virtual machines