start

limactl start

Start an instance of Lima

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

Examples


  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

Options

      --arch string                     [limactl create] Machine architecture (x86_64, aarch64, riscv64, armv7l, s390x, ppc64le)
      --arch-variant string             [limactl create] Architecture variant (e.g. "v3" for x86-64-v3)
      --audio-device string             [limactl create] Audio device backend (e.g., 'pa', 'coreaudio', 'none')
      --audio-interface string          [limactl create] Audio virtual hardware interface ('hda' or 'virtio')
      --audio-microphone[=true|false]   [limactl create] Attach an audio input stream as well as playback (vz only)
      --block-device strings            [limactl create] Host block devices to attach (macOS VZ), e.g. /dev/disk4; requires a protected helper and 'limactl sudoers --block-device' setup
      --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[=true|false]         Run the hostagent in the foreground
  -h, --help[=true|false]               help for start
      --image-variant string            [limactl create] Image variant
      --list-drivers[=true|false]       [limactl create] List available drivers and exit
      --list-templates[=true|false]     [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[=true|false]      [limactl create] Enable inotify for mounts
      --mount-none[=true|false]         [limactl create] Remove all mounts
      --mount-only strings              [limactl create] Similar to --mount, but overrides the existing mounts
      --mount-type string               [limactl create] Mount type (reverse-sshfs, 9p, virtiofs)
      --mount-writable[=true|false]     [limactl create] Make all mounts writable
      --name string                     [limactl create] Override the instance name
      --nested-virt[=true|false]        [limactl create] Enable nested virtualization
      --network strings                 [limactl create] Additional networks, e.g., "vzNAT" or "lima:shared" to assign vmnet IP
      --param stringArray               [limactl create] Set a template parameter, e.g. name=value. Can be passed multiple times.
      --plain[=true|false]              [limactl create] Plain mode. Disables mounts, port forwarding, containerd, etc.
      --port-forward stringArray        [limactl create] Port forwards (host:guest), e.g., '8080:80' or '9090:9090,static=true' for static port-forwards
      --progress[=true|false]           Show provision script progress by tailing cloud-init logs
      --rosetta[=true|false]            [limactl create] Enable Rosetta (for vz instances)
      --set stringArray                 [limactl create] Modify the template inplace, using yq syntax. Can be passed multiple times. See 'limactl help yq-restrictions' for limitations.
      --shell string                    [limactl create] User login shell in the guest (e.g. /bin/bash, /bin/zsh)
      --ssh-port uint16                 [limactl create] SSH port (0 for random)
      --timeout duration                Duration to wait for the instance to be running before timing out (default 10m0s)
      --video[=true|false]              [limactl create] Enable video output (has negative performance impact for QEMU)
      --vm-type string                  [limactl create] Virtual machine type

Options inherited from parent commands

      --debug[=true|false]   Debug mode
      --log-format string    Set the logging format [text, json] (default "text")
      --log-level string     Set the logging level [trace, debug, info, warn, error]
      --tty[=true|false]     Enable TUI interactions such as opening an editor. Defaults to true when stdout is a terminal. Set to false for automation.
  -y, --yes[=true|false]     Alias of --tty=false

SEE ALSO

  • limactl - Lima: Linux virtual machines