备注

AI Translation Notice

This document was automatically translated by hunyuan-turbos-latest model, for reference only.

  • Source document: introduction/develop_nix.md

  • Translation time: 2025-12-26 10:51:53

  • Translation model: hunyuan-turbos-latest

Please report issues via Community Channel

Developing DragonOS with Nix

The introduction of Nix eliminates the dependency on manually maintained bootstrap.sh for the DragonOS development environment. Now, any Linux distribution can quickly build and run DragonOS by installing the Nix environment!

Installing Nix and Enabling Flake Support

Refer to https://nixos.org/download/ to install Nix: The Nix package manager. (Not NixOS!)

Refer to https://wiki.nixos.org/wiki/Flakes#Setup to enable flake support.

  • If you want to experience declarative management with Nix without altering your distribution, try home-manager and configure it to enable flakes and direnv.

  • Otherwise, you can directly install flakes in a standalone Nix manner or prepend --experimental-features 'nix-command flakes' to each command.

Cloning the Repository

DragonOS now has repository mirrors on multiple hosting platforms:

  • https://github.com/DragonOS-Community/DragonOS.git

  • https://atomgit.com/DragonOS-Community/DragonOS.git

  • https://cnb.cool/DragonOS-Community/DragonOS.git

git clone https://atomgit.com/DragonOS-Community/DragonOS.git
cd DragonOS

Activating the Kernel Compilation Environment

nix develop ./tools/nix-dev-shell

If you have configured direnv, entering the repository directory for the first time will prompt you to execute direnv allow, which is equivalent to automatically entering the nix develop environment.

Compiling the Kernel

Execute the compilation:

make kernel

By default, this will compile the kernel ELF to ./bin/kernel/kernel.elf

Building the Root Filesystem

nix run .#rootfs.x86_64

This will generate ./bin/qemu-system-x86_64.img

Booting the Kernel

nix run .#start.x86_64

Now you can see your terminal loading DragonOS.

备注

To exit the DragonOS (QEMU) environment, type ctrl + a, then x

More Nix Command Usage and Nix Script Maintenance

  • cd docs && nix run Build documentation and start an HTTP server

  • If storage space is limited, nix store gc to clean up dangling historical build copies

  • In the project root directory, nix flake show to view available build targets

  • For more user-space builds related to Nix, see the Userland section.