This is the first preview version and of NanaBox. I will try to publish NanaBox 1.0 or future stable versions to Windows Store. All preview version will only release to GitHub Releases and use self signing certificate.
Note: NanaBox maybe the first open-source third-party Hyper-V client based on Host Compute System API.
Known issues
- The localization for the NanaBox UI is not implemented in NanaBox 1.0 Preview 1.
- The virtual machine creation UI and settings UI is not implemented in NanaBox 1.0 Preview 1.
- The automatic switch between Enhanced Session Mode and Basic Session Mode is not implemented because HcsEventSystemRdpEnhancedModeStateChanged event can be fired on at least Windows 10 Build 17763, but in Windows 11 Build 22621 cannot. It's confirmed as a HCS API bug via a friendly Microsoft employee and will fix it in the future.
- TPM support is not available because current stage of HCS API seems doesn't implement them.
- NanaBox needs elevated privilege via UAC because HCN API in Windows 11 Build 22621 will return ERROR_ACCESS_DENIED even add the current user to the Hyper-V Administrators user group. Windows 10 don't have that issue.
- Due to HCS API limitation, the guest only supports UEFI Class 3 or UEFI without CSM or Hyper-V Gen 2 VM.
Release Notes
NanaBox 1.0 Preview 1 (1.0.112.0)
- Use Host Compute System API as virtualization backend.
- Packaging with MSIX for modern deployment experience.
- Modernize the UI with XAML Islands with dark and light mode support. (Dynamic dark and light mode switching is supported for Windows 11 and later.)
- Add full High DPI and partial Accessibility support.
Usage
Step 1: Install the self signing certificate.
Download MouriNaruto.cer in the attachment and execute Certutil -addStore Root "[The path of MouriNaruto.cer]" in the Command Prompt which is run as the Administrator.
Step 2: Install the NanaBox
Download NanaBoxPackage_1.0.112.0_x64_arm64.msixbundle, double click to install it, or you can execute the following command in the Command Prompt which is run as the Administrator.
PowerShell -NoLogo -NoProfile -NonInteractive -InputFormat None -ExecutionPolicy Bypass Add-AppxPackage -DeferRegistrationWhenPackagesAreInUse -ForceUpdateFromAnyVersion -Path
The path of the MSIX package
NanaBox Configuration File Reference
https://github.com/M2Team/NanaBox/blob/main/Documents/ConfigurationReference.md
Kenji Mouri