Using NeKernel: Deploying

Jump to bottom

Amlal El Mahrouss edited this page Mar 8, 2026 · 1 revision

Abstract:

As NeKernel is able to run on real hardware, here's a tutorial on how to reproduce this:

Steps:

Install NeBuild (https://src.nekernel.org/nebuild)
Build in debug mode (./scripts/debug_*.sh)
Copy the contents of /kernel/src/boot/src/root/ to the mounted USB device filesystem.
- or you can copy the UDF image directly.
You should be able to see BootZ's output then NeKernel's after turning on the computer.

Notes:

NeKernel has its own partition map, EPM (and VEPM for x64 machines), although pure GPT is supported, we recommend VEPM over pure EPM for x64 platforms, unless it uses the NeBoot firmware.

Using "AI" on NeKernel:

Please read this: https://docs.kernel.org/process/coding-assistants.html

Note for Contributors:

Test your code!

If it can't run on your machine, you can't PR it. Please actually test your code before submitting!

On inactive PRs:

They will be closed after a week. Inactive PRs stalls everything.

Cheers. Amlal