Documentation

Getting started

Create a workspace, connect GitHub, and run an eligible GitHub Actions job.

Before you begin

Runzivo self-service supports GitHub Actions on Linux x64. Sign in to the customer portal with GitHub, then create or choose a workspace. You need an organization you own and a repository where you can update a workflow.

Use a repository where you can safely test a workflow change. Keep your existing workflow trigger and steps unchanged for the first run.

Open the customer portal

Read the GitHub App installation guide

First run

Sign in with GitHub, then create or choose a workspace.
In the portal, connect your GitHub organization and select the repository you want to authorize.
Copy the eligible Runzivo Linux x64 label into the job's runs-on value.
Commit and push the workflow change.
Run the workflow, then view the result in GitHub Actions and the portal.

Review GitHub App permissions

Minimal workflow change

Change only the runner label at first. Your existing actions and job steps remain in the workflow.

Use the eligible label shown in the portal.

rzv-ubuntu-24.04-x64-2vcpu-8gb is the only size admitting real jobs today. Other sizes are not yet available, even if published elsewhere.

workflow.yml

jobs:
  test:
    runs-on: rzv-ubuntu-24.04-x64-2vcpu-8gb
    steps:
      - uses: actions/checkout@v7
      - run: npm test

Confirm the run

Open the workflow run in GitHub Actions and its job result in the portal. If the job cannot start, use the troubleshooting guide before changing workflow logic.