NAME

limactl-start - Start an instance of Lima

SYNOPSIS

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

DESCRIPTION

Start an instance of Lima

OPTIONS

--arch="" [limactl create] Machine architecture (x86_64, aarch64, riscv64, armv7l, s390x, ppc64le)

--audio-device="" [limactl create] Audio device backend (e.g., 'pa', 'coreaudio', 'none')

--audio-interface="" [limactl create] Audio virtual hardware interface ('hda' or 'virtio')

--containerd="" [limactl create] containerd mode (user, system, user+system, none)

--cpus=0 [limactl create] Number of CPUs

--disk=0 [limactl create] Disk size in GiB

--dns=[] [limactl create] Specify custom DNS (disable host resolver)

--foreground[=false] Run the hostagent in the foreground

-h, --help[=false] help for start

--image-variant="" [limactl create] Image variant

--list-drivers[=false] [limactl create] List available drivers and exit

--list-templates[=false] [limactl create] List available templates and exit

--memory=0 [limactl create] Memory in GiB

--mount=[] [limactl create] Directories to mount, suffix ':w' for writable (Do not specify directories that overlap with the existing mounts)

--mount-inotify[=false] [limactl create] Enable inotify for mounts

--mount-none[=false] [limactl create] Remove all mounts

--mount-only=[] [limactl create] Similar to --mount, but overrides the existing mounts

--mount-type="" [limactl create] Mount type (reverse-sshfs, 9p, virtiofs)

--mount-writable[=false] [limactl create] Make all mounts writable

--name="" [limactl create] Override the instance name

--nested-virt[=false] [limactl create] Enable nested virtualization

--network=[] [limactl create] Additional networks, e.g., "vzNAT" or "lima:shared" to assign vmnet IP

--param=[] [limactl create] Set a template parameter, e.g. name=value. Can be passed multiple times.

--plain[=false] [limactl create] Plain mode. Disables mounts, port forwarding, containerd, etc.

--port-forward=[] [limactl create] Port forwards (host:guest), e.g., '8080:80' or '9090:9090,static=true' for static port-forwards

--progress[=false] Show provision script progress by tailing cloud-init logs

--rosetta[=false] [limactl create] Enable Rosetta (for vz instances)

--set=[] [limactl create] Modify the template inplace, using yq syntax. Can be passed multiple times. See 'limactl help yq-restrictions' for limitations.

--shell="" [limactl create] User login shell in the guest (e.g. /bin/bash, /bin/zsh)

--ssh-port=0 [limactl create] SSH port (0 for random)

--timeout=10m0s Duration to wait for the instance to be running before timing out

--video[=false] [limactl create] Enable video output (has negative performance impact for QEMU)

--vm-type="" [limactl create] Virtual machine type

OPTIONS INHERITED FROM PARENT COMMANDS

--debug[=false] Debug mode

--log-format="text" Set the logging format [text, json]

--log-level="" Set the logging level [trace, debug, info, warn, error]

--tty[=false] Enable TUI interactions such as opening an editor. Defaults to true when stdout is a terminal. Set to false for automation.

-y, --yes[=false] Alias of --tty=false

EXAMPLE

  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

SEE ALSO

limactl(1)