Skip to content

Conversation

@austinp0573
Copy link
Contributor

@austinp0573 austinp0573 commented Jan 6, 2026

Linux Development Setup for Windows VM

This PR adds tooling to make it easier for Linux developers to work on OWL Control using a Windows VM.

Since OWL Control needs Windows-specific APIs and OBS integration, I put together some scripts and documentation to streamline the VM setup process. I've tested everything on Debian 13 and it works.

What's included:

Scripts:

  • owl-dev-setup.sh - Main interactive menu to keep things simple
  • owl-install-prerequisites.sh - Sets up QEMU/KVM, virt-manager, and Samba
  • owl-cleanup.sh - Cleans everything up when you're done or want to start fresh
  • owl-windows-dev-setup.ps1 - Handles the Windows side setup automatically

Documentation:

  • LINUX_DEV_SETUP.md - Step-by-step walkthrough with troubleshooting tips for the issues I ran into
  • Updated CONTRIBUTING.md to point Linux devs to the new guide

The setup uses Samba for file sharing, so you can edit code on Linux and build/test in the Windows VM. The guide walks through creating the VM manually in virt-manager (found this was more reliable than trying to fully automate it), and includes all the quirks I discovered during testing.

It works!

I'm happy to make adjustments if needed.


 

466f724a616e6574

…up a Windows 11 VM on Linux for testing purposes.
@SandersAaronD
Copy link
Contributor

I think probably we don't want these in root, maybe probably put them in ./tools/vm? ie, the place we already have our oddball utilities in.

This may break pathing on your scripts though and require some amount of rewrite, sorry.

@SandersAaronD
Copy link
Contributor

On further reflection I don't care if I've tested this or not yet, it's better to have the code that's attested to work at least once for this on main than not so I'm approving.

@SandersAaronD SandersAaronD merged commit b9485cd into Wayfarer-Labs:main Jan 6, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants