Skip to main content

index

wootc

Goal: try Linux inside Windows, keep your work, and choose native boot later.

Latest releaseNightly E2ECILicense

wootc walkthrough — Windows 11 → deployer → native Linux → native graduation
▶ A published native cycle with a green result, sped up. It shows the stages selected by that run; a Windows return is a separate check. Play the full timelapse. The publish gate needs a green run.


wootc installs a real Linux desktop from a bootc image into root.disk, a file beside your Windows files. The latest full release, v0.1.0-alpha.1, uses Wails. Native WinUI packaging is implemented on main, but a released native setup and its acceptance evidence remain outstanding. Verification status distinguishes these builds and their limits.

The setup form asks for a password. The app suggests your username and computer name from your PC. It sizes the disk from available space and selects TPM encryption by default. Advanced lets you change those choices. Supported migration helpers can carry files, Wi-Fi networks, wallpaper, and taskbar choices. Results depend on the image and helper.

Contribute compute — no code needed​

Donate time with your AI CLI.

Your machine runs one task at a time using your signed-in AI coding CLI. The relay alternates between eligible School (OS) and Reef (apps) hives after each task. If one hive has no work, the other can continue.

The guide covers prerequisites, verified just setup, credentials, provider costs, and how to stop with Ctrl+C. Your subscription quota or API charges apply. Never post account credentials or API keys in issues or pull requests.

Get it​

No published release has the native setup yet. The files below come with the first release after the native shell cutover (#661). The latest release, v0.1.0-alpha.1 (2026-08-22), is older. It has wootc.exe, the branded *-Installer.exe files and SHA256SUMS.

⬇ Download the latest release — the latest full release is v0.1.0-alpha.1. Download wootc.exe, keep it beside its downloaded boot artifacts, and run it as Administrator. This release uses the Wails UI and requires WebView2.

Its branded executables are Bazzite-Installer.exe, Bluefin-Installer.exe, Aurora-Installer.exe, and TunaOS-Installer.exe. A branded build is not evidence of upstream endorsement; see the approval record.

The code on main prepares the native WinUI shell and protected engine as wootc-Installer-Setup.exe and branded *-Installer-Setup.exe assets, with one wootc-legacy.exe fallback. Those assets are not in the latest full release. Use the asset list of the release you downloaded, not a filename from a newer build's instructions.

winget install TunaOS.wootc is the intended package command. The first submission and clean-machine installation remain gated by #221; do not assume availability.

The binaries are not yet code-signed. Windows may show SmartScreen or an "unknown publisher" prompt. Policy can prevent continuation. First steps explains those prompts; the user guide describes later steps and uninstall limits. For a hardware trial, read the manual test guide first.

How it works​

Windows 11 → installer GUI → reboot
→ signed shim → GRUB → deployer initramfs
→ fisherman: bootc install into root.disk
→ reboot → Windows → Manage: choose Linux boot
→ native Linux, loop-mounted from root.disk
→ (optional, later) graduate to a real partition
  1. Arm. The app creates root.disk on the selected drive and stages a signed boot chain on the ESP. It changes Windows startup settings and sets a one-shot boot entry before you restart.
  2. Deploy. Under Secure Boot, the signed chain launches the installer environment. It writes the chosen OS image into root.disk, with optional LUKS/TPM2 encryption. Windows normally returns after deployment. Manage offers an explicit Linux boot choice.
  3. Live in both. A boot hook attaches root.disk and boots the native Linux system. Windows stays on the boot menu. Supported bridges expose your selected files from Windows in Linux.
  4. Choose what comes next. Graduate Linux to a blank disk after explicit checks, or keep both systems. Uninstall tries cleanup; it can leave files or boot state behind. Linux data removal is a separate choice in Manage.

What you get​

  • A password is the whole form. Solid defaults for everything else, stated on screen and adjustable under Advanced.
  • Migration helpers cover files, Wi-Fi networks, wallpaper, accent color, keyboard layout, and taskbar pins. They also cover browser profiles (Firefox, Chrome, Edge), Steam libraries, MS Office → LibreOffice choices, and WSL dotfiles/packages. A complete Firefox profile can include saved passwords. Other app sessions may need you to sign in again. See the user guide for each helper's limits.
  • BitLocker-safe by design. C: is never decrypted — Linux gets its own unencrypted space while your Windows drive stays protected. Gated off in the alpha until the FDE path is matrix-green (#34). The app stops and explains this gate on an encrypted drive.
  • Image catalog — GNOME, KDE Plasma, Niri, and XFCE desktops on Enterprise Linux, Fedora, Arch, and Debian bases. Custom OCI images need the channel and compatibility gates.
  • VM-first goal — Linux must run inside Windows before native boot. The complete Windows-hosted desktop and persistent user-work journey remain unproved.
  • An honest way back. Windows Apps offers uninstall. Cleanup can fail and report incomplete restoration. Partition removal needs current ownership and disk checks. Linux data removal is a separate choice.

Trust, engineered​

Automatic tagged releases need a full end-to-end run on the selected build. The current tagged workflow uses the real GUI in Windows 11 with Secure Boot and TPM 2.0. It selects native deployment, Linux boot, and graduation. That path ends in graduated Linux; it does not prove a Windows return after graduation.

The manual emergency waiver remains in release instructions. Nightly green runs can cut automatic pre-releases from their tested commit. Required checks must pass before a normal release.

The matrix in docs/status.md records image families, Windows editions, filesystems, and encryption modes. Earlier releases (v0.1.0-alpha.1 and the automatic pre-releases) do not prove the current VM-first or native-shell journey. See the ROADMAP for the version ladder and evidence gates. docs/philosophy.md explains the product goals.

Documentation​

Documentation indexall current guides, engineering references, and historical collections
Getting starteddownload → first boot, screen by screen
User guideliving in the migrated system, and the way back
Philosophythe North Star, the Wubi heritage, why a file
Statusthe proven matrix and its evidence
SPECthe full specification
Architecture boundarythe generic-migration / bootc seam
NTFS on Linuxthe known hazards, and why the design survives them
Borrowed from Libertixsix boot-chain and recovery designs, specified against wootc's code, with task lists
WinUI 3 shellthe native Windows shell that replaces Wails: architecture, engine protocol, cut-over
Branding & distributionone engine, five installers
Manual testingpre-flight for real-hardware runs

Contributing​

The current Windows app uses Wails (Go + web). The stack also has a dracut deployer initramfs, POSIX-shell migration tools, and a KVM E2E harness. That harness drives the real GUI in Windows VMs.

just test # fast tier: bats + go, no containers
just build # deployer initramfs + custom GRUB
cd tests/gui && npx playwright test # GUI suite over the built frontend

See the contribution guide. Start with a red or unproven matrix cell or an incomplete milestone task on the task boards.

License​

Installer components for Windows derive from WubiUEFI and use GPL-2.0 (LICENSE-GPL-2.0); the deployer initramfs and GRUB configuration are MIT (LICENSE-MIT). The slurp Go module is also MIT (slurp/LICENSE). fisherman, bootc, bootupd, podman, and skopeo are separate binaries under their own (Apache-2.0) licenses, invoked over a process boundary.