Helping Linux hosts host happy Omarchy guests
LSO makes it easy for Linux users to try out Omarchy. It's nothing like WSL and may feel like a virsh wrapper, but no one can stop us from naming it LSO :)
Put lso on your PATH. You'll need a Linux host with KVM, libvirt, OVMF and virt-viewer.
lso install --check # check host requirements
lso install # create an instance and choose a username/password
lso desktop --fullscreen # open the Omarchy desktopPrefer a terminal?
lso # open an interactive guest shell
lso shell omarchy version
# 4.0.6-1Or stream an individual app onto your host desktop:
lso app list
lso app firefoxApp streaming requires waypipe on both host and guest; LSO does not install it automatically. The full desktop does not need it.
LSO uses a supplied ISO, then checks ~/.lso/cache/, then downloads Omarchy 4.0.6 if needed. The download is roughly 6 GiB and requires curl. ISO files are checked for being non-empty, not cryptographically verified. Missing or empty supplied files fall back to the cache/download.
lso install --iso /path/to/omarchy.isoInstallation is headless by default and does not upgrade the guest OS. Instance files live under ~/.lso/<name>/; the default name is default.
lso install --name work --resource low # create a smaller named instance
lso list # list instances
lso -n work # open its shell
lso status -n work # show state and resource usage
lso stop -n work # shut it down
lso env -n work # show its file pathsUse lso shell <command...> for guest commands, not lso <command>. Unsupported options are rejected with a usage hint and exit code 2; for example, --full suggests --fullscreen. See lso --help for all options.
Currently LSO is extensively tested on Ubuntu (24.04 host). Please feel free to open a PR to support more distros.
0BSD. Upstream projects, including Omarchy, retain their own licenses.