Welcome to the Windows Subsystem for FreeBSD (WSFB)

⚡ Experimental Project – Running FreeBSD on WSL2 ⚡

This repository hosts work-in-progress efforts to run FreeBSD inside Windows Subsystem for Linux (WSL2) with minimal to no changes to the FreeBSD base system. The project builds on the open-source components of WSL2 to enable FreeBSD to boot and run seamlessly in a Windows environment.

Technical description and video available here - https://x.com/balajesankar/status/1970585411153207715

---

Project Goals

• Enable FreeBSD to run natively on WSL2’s architecture
• Make minimal or no modifications to the FreeBSD base system
• Contribute improvements back to open-source components where possible

---

Current Status

🚧 This is an experimental personal project. Here is what works now

• FreeBSD boots successfully inside WSL2
• Basic functionality is up and running
• Ongoing work focuses on networking, I/O, and process management

---

Roadmap (High-Level)

• Initial boot support (done experimentally)
• Full Console Support executing Commands
• Networking support (in progress)
• User-mode utilities and integration
• Documentation and examples

---

Contributing

At this stage, contributions are welcome in the form of:

• Feedback or testing results
• Bug reports
• Discussions and ideas

Please open an issue or start a discussion to get involved.

---

License

This project is released under an open-source license (TBD).

---

Disclaimer

This is a personal, experimental project and is not affiliated with Microsoft, the FreeBSD Foundation, or the FreeBSD Project. Use at your own risk.