一个免费的 NT 操作系统,目标是与 Windows 11 兼容,覆盖 amd64、arm64、riscv64 三种架构。名字取自拉丁语 liber,意为自由,诞生于对 NT 架构的喜爱,除兼容性之外也留给实验性特性发挥空间。文档把当前状态说得很直白:项目仍在活跃开发中,Releases 页面上的构建是 Debug 预发布版,仅供测试,应当在虚拟机或闲置硬件上运行,不要装进日常依赖的电脑。仓库涉及驱动程序、内核与操作系统三类内容,README 提供英、中、法、西、日、阿拉伯、乌克兰七种语言版本。附图的桌面截图来自 arm64 构建在 QEMU 中的实际运行画面。适合关注内核与跨架构移植的开发者跟踪。GPL-3.0 许可。
English | 中文 | Français | Español | 日本語 | العربية | Українська
[!IMPORTANT] LiberNT is in active development. The builds on the Releases page are Debug pre-releases for testing: run them in a virtual machine or on spare hardware, not on a computer you depend on.
The LiberNT desktop on arm64, from build nt10.0-043-2555 in QEMU
LiberNT is a free NT operating system. The name says it: liber is Latin for free. It targets Windows® 11 compatibility, with room for freestyle and experimental features.
LiberNT brings extensive work on kernel-space components and drivers, aimed at stability and modern hardware, and it focuses on 64-bit platforms: amd64, arm64 and riscv64.
Our goal is a system that stays maintainable in the long run: stable, reliable and efficient, running on embedded devices too, and able to support every feature a modern operating system should have.
[!NOTE] New to NT? NT is the architecture behind every modern version of Windows: its kernel, driver model and system services. LiberNT is a free operating system built on that architecture, and Windows 11 is the reference it measures itself against.
LiberNT brings modern hardware and platforms to the NT architecture.
| Feature | What it means for you |
|---|---|
| 64-bit first | The kernel, HAL and FreeLoader run on amd64, arm64 and riscv64. |
| UEFI boot | Boots on UEFI firmware, with a GOP framebuffer and early display support. The preinstalled disk boots with UEFI or BIOS. |
| Modern buses and storage | PCIe, PCI, Plug and Play, USB with xHCI, SD/eMMC, and storage and bus drivers. |
| Board support | Real boards, including the Raspberry Pi and its RP1 I/O controller. |
| The Windows 11 driver model | Windows 11 (NT10) compatibility and driver-model work, checked against Windows 11 itself. |
| Graphics and x86 apps on Arm | The graphics driver model with Mesa, and WoW64 with FEX, are build options you can switch on. |
| LiberNT Setup | Lists drives the way Windows Setup does, creates, deletes, formats, shrinks and extends partitions, and installs LiberNT on NTFS with the EFI system partition it needs. |
| Your own build | menuconfig lets you choose the target, compiler and build type, and switch features on or off. |
[!TIP] Each build on the Releases page lists what changed since the previous one.
| Architecture | Prebuilt images | Build from source | Notes |
|---|---|---|---|
| amd64 | ✓ | ✓ | Clang (default) or GCC |
| arm64 | ✓ | ✓ | Includes Raspberry Pi support |
| riscv64 | ✓ | ✓ | A separate image is built for JH7110 boards |
| i386 | ✓ | 32-bit x86 |
Release builds also include PowerPC images.
Every build on the Releases page comes as one ZIP file per image and architecture:
| File | What it is |
|---|---|
bootcd-iso-…-<arch>-…zip |
bootcd.iso, a CD image that runs LiberNT or starts LiberNT Setup |
LiberNT-img-…-<arch>-…zip |
LiberNT.img, a disk with LiberNT already installed |
LiberNT-vhd-…-<arch>-…zip |
LiberNT.vhd, the same preinstalled disk for VHD-based virtual machines |
LiberNT-vhdx-…-<arch>-…zip |
LiberNT.vhdx, the same preinstalled disk for Hyper-V Generation 2 |
[!NOTE] These are Clang Debug builds, made by GitHub Actions from the
masterbranch.
The quickest way to try LiberNT is the preinstalled disk:
LiberNT.img (or LiberNT.vhd)LiberNT.vhdx, with Secure Boot turned offLiberNT.img to a USB drive or an SD card and boot the machine from it. It boots with UEFI or BIOS[!CAUTION] Writing
LiberNT.imgto a USB drive or an SD card erases everything on it. Double-check the target device first.
Boot bootcd.iso in a virtual machine or on a PC, and follow the instructions of LiberNT Setup.
The preinstalled disk also carries LiberNT Setup. Run C:\<architecture>\libernt.exe, for example C:\arm64\libernt.exe, to install LiberNT on another disk from the running system.
[!CAUTION] Setup can delete and format partitions. Back up anything important on the target disk before you install.
See INSTALL.md for the full installation guide.
LiberNT builds with RosBE, a cross-build toolchain. The steps below work on Linux and macOS, and on Windows through WSL2.
You need Git, CMake, Ninja and a C/C++ compiler for your own machine. RosBE adds the compilers that build LiberNT.
curl -fsSL https://raw.githubusercontent.com/LiberNT/libernt-build-toolchain/main/rosbe-unix-bootstrap.sh | sh
[!TIP] On Windows, we suggest WSL2. Install it with
wsl --install, open the Linux terminal it adds, and follow the Linux steps there. Keep the source inside the Linux file system rather than under/mnt/c, where builds run slower.
git clone https://github.com/LiberNT/LiberNT.git
cd LiberNT
[!NOTE] The first configure run also fetches the submodule and external sources the build needs.
./configure.sh
With no options, this sets up an AMD64 Debug build with Clang in the folder output-Clang-amd64-debug. The folder name always follows the pattern output-<compiler>-<architecture>-<debug|release>.
| Option | What it does |
|---|---|
-a, --arch <arch> |
Chooses the target architecture: amd64 (default), i386, arm64 or riscv64. |
--clang |
Builds with Clang/LLVM from RosBE. This is the default. |
--gcc |
Builds with GCC from RosBE instead of Clang. The macOS RosBE does not include GCC. |
-r, --release |
Makes an optimized Release build. Without it you get a Debug build, which is easier to debug. |
menuconfig |
Opens a menu to choose optional components first. Your choices are kept in the output folder. |
makefiles |
Uses make instead of Ninja. |
--no-feeds-update |
Skips fetching the external sources listed in feeds.conf, for example when offline. |
-D<name>=<value> |
Passes a setting straight to CMake. |
For example:
./configure.sh -a arm64 # ARM64 Debug build with Clang
./configure.sh -a i386 --gcc # 32-bit x86 build with GCC
./configure.sh -a amd64 --release # optimized AMD64 build
For a more personalized build, add menuconfig:
./configure.sh menuconfig
It opens a menu, much like the Linux kernel's, where you choose the target, compiler and build type, and switch features on or off: code generation and tuning, graphics driver model and Mesa, WoW64 and FEX, kernel debugging, test runs and more. Press ? on any option for help, S to save and Q to quit. Your choices are saved in the output folder and used every time you configure it again.
Go to the output folder and run Ninja with the target you want:
cd output-Clang-amd64-debug
ninja liberntimg
| Command | Creates | Use it to |
|---|---|---|
ninja bootcd |
bootcd.iso |
Install LiberNT from a CD image, in a virtual machine or on a PC. |
ninja liberntimg |
LiberNT.img |
Boot a disk with LiberNT already installed. Start it in a virtual machine such as QEMU, or write it to a USB drive or SD card. It boots with UEFI or BIOS. |
ninja liberntvhd |
LiberNT.vhd, LiberNT.vhdx |
Use the same preinstalled disk in virtual machines: the VHD in VirtualBox and Hyper-V Generation 1, the VHDX in Hyper-V Generation 2, which does not take VHD disks. |
Each target builds everything it needs first, and the files are written to the output folder.
| Host | Compilers | Notes |
|---|---|---|
| Linux x86_64 / aarch64 | Clang and GCC | The full RosBE toolchain |
| macOS Intel / Apple Silicon | Clang | RosBE has no GCC build for macOS |
| Windows | Clang and GCC | Through WSL2, following the Linux steps |
On every host, install Git, CMake, Ninja, Flex and Bison from your package manager. RosBE provides only the cross compilers. Prebuilt toolchains live in LiberNT/libernt-build-toolchain.
LiberNT/
├── base/ # Applications, services, setup and the shell
├── boot/ # FreeLoader, boot data and boot images
├── bootloader/ # Boot manager, Windows loader, UEFI and Open Firmware support
├── dll/ # User-mode DLLs, including ntdll and the Win32 libraries
├── drivers/ # Kernel-mode drivers: buses, storage, file systems, network, input and more
├── hal/ # Hardware abstraction layers for x86, Arm, Arm64, PowerPC and RISC-V
├── media/ # Fonts, themes, INF files, sounds and branding
├── modules/ # Optional applications, tests and wallpapers
├── ntos/ # The NT kernel and executive
├── sdk/ # Headers, libraries and build tools
├── submodules/ # Recipes and patches for external components
├── subsystems/ # CSRSS and the Windows subsystem
│ └── win/win32k/ # win32k, USER, GDI and display drivers
├── configure.sh # Sets up a build on Linux, macOS and WSL2
└── configure.cmd # Sets up a build on Windows
Report bugs and suggest features in Issues, and find guides and notes in the Wiki.
See CONTRIBUTING.md and PULL_REQUEST_MANAGEMENT.md. If you're planning a larger change, ask in Issues or on Discord first.
[!WARNING] Legal notice: If you have seen proprietary Microsoft Windows source code (including but not limited to the leaked Windows NT 3.5, NT 4, 2000 source code and the Windows Research Kernel), your contribution won't be accepted because of potential copyright violation.
We want to make it clear: AI is part of how LiberNT is built. It helps us review and write code, and everything it writes is then reviewed by a human. Before anything reaches the main branch, a person runs and validates the end-to-end tests. We care about this project too much to let a regression slip through.
It also helps us read documentation, extract definitions and fix bugs. For any given bug, it compares what the official Microsoft Learn documentation says with what our function actually does, so we can see exactly where our behavior differs.
Like any other tool, AI is there to help us achieve our goals. It follows the same rules we hold ourselves to, set out in AGENTS.md:
[!TIP] If you use AI in your own contributions, you are welcome here too. Just tell us in the pull request which parts it helped with and how you tested them. That honesty is all we ask.
LiberNT is licensed under the GNU GPL 3.0. Code inherited from other projects keeps the licence stated in its file headers, most of it GPL 2.0 or later. The GPL 2.0, LGPL 2.1 and BSD texts those files refer to are in COPYING2, COPYING.LIB and COPYING.ARM.
The changes made in LiberNT are Copyright © 2026 the LiberNT contributors. Inherited and third-party code keeps the copyright notices of its authors. See CREDITS.md.
The GPL covers the code, not the brand. LiberNT™ and the LiberNT logo are the project's marks, and the artwork in media/graphics/branding is copyright its author, all rights reserved. TRADEMARK.md says what you may do with them without asking: refer to the project, redistribute an official build unchanged, link to us. A modified build needs its own name.
LiberNT is an independent project. It is not affiliated with, endorsed by or sponsored by Microsoft. Windows® is a registered trademark of Microsoft Corporation.
LiberNT is built by the LiberNT contributors. It was started by Ahmed Arif and is maintained by Ahmed Arif, Ostap Brehin and Vivyy.
| 日期 | 榜单 | 排名 | 周期新增 | 总 STAR |
|---|