Skip to Content

RISC-V GitHub Runners

Run your GitHub Actions CI on real RISC-V hardware. Install the app once, and runners are provisioned automatically whenever your jobs need them.

Install the GitHub App

One installation covers your repository. No tokens to generate, nothing to renew, no waiting on this page.

Install on GitHub

Takes about two minutes. Read the setup guide

How it works

1

Install the app on your repository

Choose the repositories that should have access to RISC-V runners. You can change this any time from your GitHub settings.

2

Point your workflow at a board

Add a board label to runs-on in your workflow file:

jobs:
  build:
    runs-on: [self-hosted, visionfive2]
    steps:
      - uses: actions/checkout@v4
      - run: make test
3

Push your code

When the job is queued, a runner is provisioned on a board for your repository, usually within a few minutes. It stays warm for your future jobs, and after 90 days it is recycled and a fresh one is provisioned on your next push.

Available boards

VisionFive 2

Accepted labels

visionfive2 vf2 vision-five-2

Milk-V Pioneer

Accepted labels

milkv-pioneer pioneer milk-v-pioneer

Banana Pi BPI-F3

Accepted labels

banana-pi-f3 bpi-f3 banana-pi

Runner environment

GitHub Actions runner

2.329.0 (RISC-V port)

Default image

riscv64/ubuntu:24.04

Runner lifetime

90 days, renews on next job

Need help?

Write to us at cloud-v@10xengineers.ai

Include your repository name, the board label you used, and any error you saw, so we can help you faster.