guideXOS Server Build and Testing

Purpose: collect the current scripts, commands, and validation paths surfaced by the Server branch.

Recommended daily workflow

powershell -ExecutionPolicy Bypass -File build.ps1 -RunQemu

This is the main Server-branch workflow. It builds the UEFI bootloader, attempts the selected kernel build, stages the ESP directory, and launches QEMU when requested.

Current status: recommended active workflow for contributors and early testers.
Known gaps: a polished public Server ISO is still coming later, so source builds remain the main path. Back to /Wiki/Server

Hosted / Windows-side builds

build.bat build-native-experimental.bat

Use the hosted build for compositor, desktop-service, Navigator, app-model, and experimental Native ELF validation work.

Kernel-only builds

cd kernel mingw32-make ARCH=amd64

The kernel path depends on GNU make / MinGW-style tooling and architecture selection.

Key scripts surfaced by the repo

  • build.ps1 – full bootloader + kernel + ESP workflow
  • build-uefi.ps1 – alias to the same UEFI-focused build flow
  • run-qemu.bat / run-uefi.sh – OVMF/QEMU boot launchers
  • scripts/run-qemu-fs-test.ps1 / .sh – filesystem test launch flows
  • sdk/build-samples.ps1 – stages Native ELF SDK sample apps for hosted runtime validation
  • build-native-experimental.bat – hosted experimental Native ELF execution validation

What contributors should verify

Validation path Why it matters
Hosted compositor / desktop service Fastest feedback loop for windows, desktop UI, app model, Navigator, and some diagnostics.
Bare-metal / QEMU UEFI path Validates bootloader, kernel handoff, framebuffer, storage, networking, and OS-side bring-up reality.
SDK sample staging Useful for manifest scanning and Native ELF sample validation in the hosted path.