RISE RISC-V Runners

Run GitHub Actions workflows on real RISC-V hardware. No emulation, no cross-compilation, your code runs on physical RISC-V boards.

RISE RISC-V Runners is a managed GitHub runner service. Install the GitHub App on your organization or personal account, set runs-on: ubuntu-24.04-riscv in your workflow, and your jobs run on dedicated RISC-V nodes with full Docker support.

RISE provides the service free of charge for any open source project. We want to make RISC-V a viable target for OSS, this is one of our contributions to that effort.

How it works

1. Your workflow triggers a workflow_job webhook
2. The webhook handler validates the request and records demand in Redis
3. A background worker provisions a Kubernetes pod on a matching RISC-V node
4. The pod registers as a just-in-time GitHub Actions runner and executes your job
5. On completion, the pod is cleaned up automatically

Runners are ephemeral. Each job gets a fresh environment. Docker-in-Docker is available in every run.

Quick start

jobs:
  build:
    runs-on: ubuntu-24.04-riscv
    steps:
      - uses: actions/checkout@v4
      - run: uname -m   # prints riscv64

See Install the GitHub App and Configure Your Workflow to get started.

Available runners

Label	OS	Hardware	Notes
ubuntu-24.04-riscv	Ubuntu 24.04	Scaleway EM-RV1	Standard runner

See the full Runner Labels Reference for hardware specs.

Architecture

The system spans four repositories:

• riscv-runner-app: GitHub App webhook handler and background worker
• riscv-runner-device-plugin: Kubernetes device plugin and node labeller
• riscv-runner-images: Runner and DinD container images
• riscv-runner-sample: Sample repository demonstrating usage

See the Architecture Overview for details.