Run limactl start template://fedora to create a Lima instance named "fedora".
To open a shell, run limactl shell fedora bash or LIMA_INSTANCE=fedora lima bash.
⭐ = "Tier 1"
☆ = "Tier 2"
Default: default (⭐Ubuntu, with containerd/nerdctl)
Distro:
almalinux-8: AlmaLinux 8almalinux-9: AlmaLinux 9almalinux-10,almalinux.yaml: AlmaLinux 10almalinux-kitten-10,almalinux-kitten.yaml: AlmaLinux Kitten 10alpine: ☆Alpine Linuxalpine-iso: ☆Alpine Linux (ISO9660 image). Compatible with thealpinetemplate used in Lima prior to v1.0.archlinux: ☆Arch Linuxcentos-stream-9,centos-stream.yaml: CentOS Stream 9centos-stream-10: CentOS Stream 10debian-12: Debian GNU/Linux 12(bookworm)debian-13,debian.yaml: ⭐Debian GNU/Linux 13(trixie)fedora-41: Fedora 41fedora-42: Fedora 42fedora-43,fedora.yaml: ⭐Fedora 43opensuse-leap-15: openSUSE Leap 15opensuse-leap-16,opensuse-leap.yaml,opensuse.yaml: ⭐openSUSE Leap 16oraclelinux-8: Oracle Linux 8oraclelinux-9: Oracle Linux 9oraclelinux-10,oraclelinux.yaml: Oracle Linux 10rocky-8: Rocky Linux 8rocky-9: Rocky Linux 9rocky-10,rocky.yaml: Rocky Linux 10ubuntu: Ubuntu (same asdefault.yamlbut without extra YAML lines)ubuntu-lts: Ubuntu LTS (same asubuntu.yamlbut pinned to an LTS version)experimental/ubuntu-next: Ubuntu vNextexperimental/gentoo: [experimental] Gentooexperimental/opensuse-tumbleweed: [experimental] openSUSE Tumbleweedexperimental/debian-sid: [experimental] Debian Sid
Alternative package managers:
linuxbrew.yaml: Homebrew on Linux (Ubuntu)
Container engines:
apptainer: Apptainerapptainer-rootful: Apptainer (rootful)docker: ⭐Dockerdocker-rootful: Docker (rootful)podman: Podmanpodman-rootful: Podman (rootful)LXD is installed in the default Ubuntu template, so there is no
lxd.yaml
Container image builders:
buildkit: BuildKit
Container orchestration:
k3s: Kubernetes via k3sk8s: ⭐Kubernetes via kubeadmexperimental/rke2: RKE2experimental/u7s: Usernetes: Rootless Kubernetes
Optional feature enablers:
experimental/vnc: [experimental] use vnc display and xorg serverexperimental/alsa: [experimental] use alsa and default audio device
Lost+found:
~
centos~: Removed in Lima v0.8.0, as CentOS 8 reached EOL. Replaced byalmalinux,centos-stream,oraclelinux, androcky.~
singularity~: Moved toapptainer-rootfulin Lima v0.13.0, as Singularity was renamed to Apptainer.~
experimental/apptainer~: Moved toapptainerin Lima v0.13.0.~
experimental/{almalinux,centos-stream-9,oraclelinux,rocky}-9~: Moved toalmalinux-9,centos-stream-9,oraclelinux-9, androcky-9in Lima v0.13.0.~
nomad~: Removed in Lima v0.17.1, as Nomad is no longer free software~
centos-stream-8~: Remove in Lima v0.23.0, as CentOS Stream 8 reached EOL.~
deprecated/centos-7~: Remove in Lima v0.23.0, as CentOS 7 reached EOL.~
experimental/vz~: Merged into the default template in Lima v1.0. See also https://lima-vm.io/docs/config/vmtype/.~
experimental/armv7l~: Merged into thedefaulttemplate in Lima v1.0. Uselimactl create --arch=armv7l template://default.~
experimental/riscv64~: Merged into thedefaulttemplate in Lima v1.0. Uselimactl create --arch=riscv64 template://default.~
vmnet~: Removed in Lima v1.0. Uselimactl create --network=lima:shared template://defaultinstead. See also https://lima-vm.io/docs/config/network/.~
experimental/net-user-v2~: Removed in Lima v1.0. Uselimactl create --network=lima:user-v2 template://defaultinstead. See also https://lima-vm.io/docs/config/network/.~
experimental/9p~: Removed in Lima v1.0. Uselimactl create --vm-type=qemu --mount-type=9p template://defaultinstead. See also https://lima-vm.io/docs/config/mount/.~
experimental/virtiofs-linux~: Removed in Lima v1.0. Uselimactl create --mount-type=virtiofs-linux template://defaultinstead. See also https://lima-vm.io/docs/config/mount/.
Tier
"Tier 1" (marked with ⭐): Good stability. Regularly tested on the CI.
"Tier 2" (marked with ☆): Moderate stability. Regularly tested on the CI.
Other templates are tested only occasionally and manually.