# Getting started

Sign in with GitHub, connect an organization, 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 connect a GitHub organization you own and select a repository where you can update a workflow. Personal repositories are not supported.

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](https://app.runzivo.dev/)

[Read the GitHub App installation guide](https://runzivo.dev/docs/github-app/)

## First run

- Sign in with GitHub, then connect a 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. If the job cannot start, use the troubleshooting guide before changing workflow logic.

[Review GitHub App permissions](https://runzivo.dev/docs/github-app-permissions/)

## Find your way around the portal

The sidebar groups the portal by area. CI & Runners holds Jobs, Runners, Runner Templates, Repositories, Insights and Pipelines. Pipelines and AI Fix appear only when they are turned on for your workspace. Services marked Soon are planned and not available yet; they don't open a page.

Workspace settings live under Settings, in tabs: General, Members & Teams, Billing & Credits, API Keys, Integrations, Notifications and AI (AI Settings in the sidebar). Your own profile, appearance, language and timezone are in the account menu at the top right.

Collapse the sidebar with the button at its bottom left. When it's collapsed, hover or focus an icon to see its name, and select a section to open its menu. Press ⌘K (Command+K) on a Mac, or Ctrl+K elsewhere, to open Quick search from any page.

## 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.

The rzv-ubuntu-24.04-x64-2vcpu-8gb, rzv-ubuntu-24.04-x64-4vcpu-16gb, rzv-ubuntu-24.04-x64-6vcpu-24gb, rzv-ubuntu-24.04-x64-8vcpu-32gb, rzv-ubuntu-24.04-x64-16vcpu-64gb, rzv-ubuntu-24.04-x64-32vcpu-128gb labels are available for real jobs today.

GitHub Actions · existing workflow job

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

On this page and page tools