X11 Support

December 12, 2025 ยท View on GitHub

StarryOS supports X11 for GUI.

Steps

  1. Make sure you run StarryOS with necessary flags:

    make img ARCH=riscv64
make run ARCH=riscv64 GRAPHIC=y INPUT=y

  2. In StarryOS, install necessary dependencies:

    apk add xorg-server xf86-video-fbdev xf86-input-evdev

  3. Start the X server and set the DISPLAY environment variable:

    X &
export DISPLAY=:0

  4. You can now run graphical applications, for example:

    apk add xcalc
xcalc

  5. dwm is also available as a lightweight window manager.

    apk add dwm
dwm &