Error: No VM managers are supported on linux yet. (WSL2 Setup)

Hi all.

My new workplace uses Windows/WSL for pretty much everything, and I’m trying to get up and running with Trellis and experiencing some issues.

  1. I install trellis via the docs: brew install roots/tap/trellis-cli.
  2. I run trellis new``example.com and it initializes the project with no errors.
  3. I cd into the directory and run trellis vm start and get the error: No VM managers are supported on linux yet.

My understanding was that trellis was supported on WSL2 and that Lima does indeed work on Linux, but some other resources are telling me the opposite. Are there other dependencies I need to install or some Lima config I need to take care of?

My WSL version is Ubuntu 24.04. Using Homebrew 5.0.16, Trellis v1.17, limactl version 2.0.3.

Tracking this here: Did you just drop Linux support? · Issue #599 · roots/trellis-cli · GitHub

Recent related PR: https://github.com/roots/trellis-cli/pull/633

But even once Linux support lands in Trellis CLI, I’m unsure of how well it will work with WSL. Previous versions of Trellis (with Vagrant and VirtualBox) supported WSL, but it was hacky, and I believe eventually stopped working at some point? I’m not 100% sure

To be honest, Trellis might not be the best fit for Windows developers. Lando and DDEV are worth looking into.