RISC-V Distros

Start here if this is your first RISC-V machine

Which distribution runs on which board, where the images live, and where the traps are. Scattered vendor wikis, gathered in one place: get it booting first, worry about speed later.

The point of this site is getting something to boot. RISC-V software support is scattered across vendor wikis, forum threads and GitHub READMEs, and newcomers usually get stuck on the same three steps: the wrong image, the wrong U-Boot, a serial console that isn’t wired up. We collect the distros, the boards and the support relationship between them in one place, with a check date and a source on every entry.

Start with Getting started for the order of operations, use the support matrix to check whether a given combination works, and when something breaks, read the pitfalls on the distro and board pages first.

Every claim carries a check date and a source; the full list and method notes live in Sources .

Distributions that actually support RISC-V

All →

Debian

Upstream architecture

Based onIndependent

Debian is the only independent distro here that made riscv64 an official release architecture; separately there are Debian-based riscv64 systems such as deepin and RevyOS (not verified one by one).

Ubuntu

Upstream architecture

Based onDebian

Ubuntu has the most detailed board support: it publishes preinstalled images per board, but 26.04 raised the bar to RVA23, leaving older boards stuck on 24.04 LTS.

Fedora

Community port

Based onIndependent

Fedora runs an official RISC-V SIG with continuous builds, but the project still labels riscv64 "not officially supported" and ships images through the alt channel. It works fine day to day; its support level is simply not the same as Debian or Ubuntu.

Fedora-V Force (FVF)

Vendor derivative

Based onFedora

FVF is a RISC-V image rebuilt from Fedora sources by a separate team, not an official Fedora release. It covers more boards than the official SIG images, so it is the practical pick when you want a Fedora userland that boots out of the box.

RevyOS

Vendor derivative

Based onDebian 13 (trixie) rootfs + XuanTie-customized 6.6 kernel (TH1520/SG2042 BSP); the older 20240720 build is Debian 12 + 5.10 kernel

The de facto standard on TH1520 boards: LicheePi 4A and Milk-V Meles ship with RevyOS, and the official tutorials flash it too. The best first pick for newcomers, but note that the mirror is newer than the docs — take the latest date from the mirror directory.

Bianbu

Vendor derivative

Based onUbuntu 24.04 LTS (Bianbu 2.x, K1) / Ubuntu 25.04 (Bianbu 3.x, K1) / Ubuntu 26.04 (Bianbu 4.x, K3; per vendor forum, not stated per release in official docs) + vendor BSP kernel 6.6 LTS / 6.18

The only system with an official desktop experience on K1/K3 boards (BPI-F3, Milk-V Jupiter, MUSE, Pico-ITX): GNOME/LXQt out of the box and complete documentation, making it the friendliest vendor distro for newcomers.

openEuler

Upstream architecture

Based onopenEuler 24.03 LTS (RPM/dnf, own repos) + RVCK 6.6 kernel; RISC-V ships as two separate builds, RVA20 and RVA23

An RISC-V base for server/enterprise use, moving fastest on RVA23 + Server Platform; unless you are validating server scenarios, RevyOS/Bianbu will save you trouble on a dev board.

openKylin

Upstream architecture

Based onIndependent build (deb/APT + own repos, UKUI desktop); 3.0 uses a Linux 7.0 kernel, 2.0 SP2 is the long-term stable release

The RISC-V branch of a domestic desktop OS, with board coverage split across versions (3.0 only knows K3/V100). Good for evaluating a domestic desktop stack, not as a daily driver on older TH1520/K1 boards.

deepin

Vendor derivative

Based onDebian-based + deepin's own repos (deepin 25 "crimson"); kernel 6.6/6.12/6.16 depending on board, mainline kernel on DP1000

The best-looking domestic desktop distro, but its RISC-V branch is a community preview shipped as per-board tar.xz files — fine for evaluation, not recommended as your only daily system.

The boards people actually use

All →

Distro by board at a glance

All →

Boards down the side, distros across the top. Each cell links to the distribution page with images and pitfalls.