Files
RedBear-OS/docs/README.md
T
vasilito 50b731f1b7 Red Bear OS — microkernel OS in Rust, based on Redox
Derivative of Redox OS (https://www.redox-os.org) adding:
- AMD GPU driver (amdgpu) via LinuxKPI compat layer
- ext4 filesystem support (ext4d scheme daemon)
- ACPI fixes for AMD bare metal (x2APIC, DMAR, IVRS, MCFG)
- Custom branding (hostname, os-release, boot identity)

Build system is full upstream Redox with RBOS overlay in local/.
Patches for kernel, base, and relibc are symlinked from local/patches/
and protected from make clean/distclean. Custom recipes live in
local/recipes/ with symlinks into the recipes/ search path.

Build:  make all CONFIG_NAME=redbear-full
Sync:   ./local/scripts/sync-upstream.sh
2026-04-12 19:05:00 +01:00

2.8 KiB

Redox OS Fork — Wayland, KDE & Linux Driver Compatibility

Technical documentation for forking Redox OS to include Wayland protocol support, KDE Plasma desktop environment, and a Linux driver compatibility layer.

Documents

# Document Description
01 Architecture Overview Redox OS internals: microkernel, scheme system, driver model, display stack
02 Gap Analysis & Roadmap What's missing between current Redox and our Wayland/KDE/driver-compat goals
03 Wayland on Redox Deep-dive into Wayland protocol requirements and current porting status
04 Linux Driver Compatibility Layer Design for a FreeBSD LinuxKPI-style driver compatibility shim
05 KDE Plasma on Redox Feasibility study and implementation plan for KDE Plasma
06 Build System Setup How to build Redox from this repository

Current State Summary (as of Redox 0.9.0)

  • Display server: Orbital (custom, scheme-based) — works
  • Wayland: Experimental, WIP. Smallvil (Smithay) and cosmic-comp partially working. libwayland patched with shimmed-out signalfd, timerfd, eventfd.
  • X11: Working via X.org dummy driver inside Orbital.
  • Mesa: Software-rendered only (LLVMpipe/OSMesa). No GPU acceleration.
  • GPU drivers: VESA framebuffer + VirtIO GPU only. Experimental Intel modesetting.
  • KDE: 19 app recipes in WIP, no KDE Plasma infrastructure.
  • Linux driver compat: None. Redox explicitly chose source-level porting over binary compat.

Quick Start

# 1. Install dependencies (Arch/Manjaro)
sudo pacman -S --needed --noconfirm gdb meson nasm patchelf python-mako \
  doxygen expat file fuse3 gmp libjpeg-turbo libpng po4a scons \
  sdl12-compat syslinux texinfo xdg-utils zstd

# 2. Install Rust + tools
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source "$HOME/.cargo/env"
cargo install just cbindgen

# 3. Configure for native build (no Podman)
echo 'PODMAN_BUILD?=0' > .config

# 4. Build (downloads cross-toolchain, then compiles)
make all

# 5. Run in QEMU
make qemu

Key Repositories

Repo Purpose URL
Kernel Microkernel https://gitlab.redox-os.org/redox-os/kernel
Base Drivers + system components https://gitlab.redox-os.org/redox-os/base
relibc C library (Rust) https://gitlab.redox-os.org/redox-os/relibc
Orbital Display server + WM https://gitlab.redox-os.org/redox-os/orbital
RedoxFS Default filesystem https://gitlab.redox-os.org/redox-os/redoxfs
libredox System library https://gitlab.redox-os.org/redox-os/libredox
This repo Build system https://gitlab.redox-os.org/redox-os/redox