alpine-lima is a build tool that creates Alpine-based ISO images for Lima, the Linux virtual machine launcher for macOS.
The tool addresses the need to produce minimal, purpose-built ISO images for Lima that can be embedded in Rancher Desktop without unnecessary bloat or security exposure. It achieves this through a modular approach, offering multiple editions tailored to different use cases: a minimal base image, a cloud-init variant for testing Lima compatibility, a standard edition using a custom init script to reduce dependencies, and a Kubernetes-ready edition with k3s pre-installed. The standard edition notably includes QEMU support for Apple Silicon binary execution through binfmt_misc configuration. The build process runs inside a Docker container and supports multiple architectures including x86_64 and aarch64, with the Alpine aports repository included as a submodule to enable custom package builds.
Developers should adopt this tool if they need to create lightweight Alpine Linux images for Lima deployments, particularly when integrating with Rancher Desktop or similar container platforms where image size and pre-bundled dependencies matter. The standard edition is the recommended choice for most Lima use cases, as it avoids the overhead of full cloud-init while including all optional Lima requirements. The tool's architecture-agnostic design means it can generate images beyond the tested x86_64 and aarch64 platforms if needed.
Development activity shows consistent maintenance with regular updates to Alpine versions and ongoing refinement of the build process. The project actively manages its submodule dependencies and responds to changes in the Alpine ecosystem. Build and testing infrastructure receives attention, with documentation covering multiple execution scenarios including Docker, QEMU, and Lima itself. The modular edition system indicates iterative development driven by real deployment requirements rather than speculative features.
