Welcome to the Winnux documentation. Here you will find everything you need to understand, use, and contribute to Winnux — from product principles to technical architecture.
Winnux product definition, target audience, principles, and decided guidelines for development.
Step-by-step guide to install Winnux — in a virtual machine or alongside Windows.
Safe transfer of files, settings, and applications from Windows to Winnux.
Technical foundation: kernel, bootc images, desktop environment, and system services.
Details about Winnux seven core components and how they work together.
Atomic updates, background downloads, and restoring to previous versions.
How to contribute with code, documentation, testing, or translations.
Report vulnerabilities, security principles, and responsible disclosure.
Winnux is distributed under the Posttyp A-IPv4 license. Read the terms and conditions.
Winnux is in early development. To get started with development or testing:
Winnux is in Phase 1–2 of development. The minimal image has completed one documented headless UEFI/KVM boot. Graphical desktop, Secure Boot, update/rollback, and physical hardware are not yet verified.
A working QEMU image is not the same as a stable release. Stable release requires a signed supply chain, SBOM/provenance, incident process, and human approval.
All code is available on GitHub under the Vexcraft-io organization: