Lima Actions is a GitHub Actions integration that enables running non-Ubuntu Linux distributions on GitHub Actions workflows.
The tool solves the problem of GitHub Actions' default Ubuntu-only environment by leveraging Lima, a lightweight virtual machine framework, to provision alternative distributions like Fedora. When a workflow uses the setup action, it installs and configures Lima within the runner, allowing subsequent steps to execute within a virtual machine running the desired distribution. This approach avoids the need to maintain custom container images or complex build matrices for testing across different Linux variants.
Developers should adopt this tool when they need to test or build software against specific non-Ubuntu distributions in CI/CD pipelines. It suits projects that require Fedora, Alpine, or other distributions as part of their testing strategy but want to remain on GitHub Actions rather than switching to alternative CI platforms. The setup action provides optional configuration for Lima version selection, SSH configuration, and installation of additional guest agents, giving users control over the environment without requiring extensive manual setup.
The project maintains active engagement with its codebase, regularly addressing issues and accepting contributions that improve the integration. Development shows responsiveness to user needs through iterative refinement of the action's interface, as evidenced by consolidation of previously separate actions into unified parameters. The maintainers demonstrate attention to usability by documenting optional parameters clearly and providing sensible defaults that work for most workflows without additional configuration.
