| Migrating from GitHub Actions: A Step-by-Step Guide

Migrating to Blaze from GitHub Actions is straightforward. This guide walks you through the process step by step.

Prerequisites

Before you start, you’ll need:

1. A GitHub repository with existing workflows
2. A Blaze account (sign up at runblaze.dev/register)
3. Admin access to your repository settings

Step 1: Add Your GitHub Handle to the Allowlist

After signing up, go to your Blaze dashboard and add your GitHub username or organization to the allowlist. Only workflows from allowed handles can use your Blaze runners.

Step 2: Update Your Workflow File

The only change required is updating the runs-on field:

# Before
jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - run: swift build

# After
jobs:
  build:
    runs-on: blaze/macos-14
    steps:
      - uses: actions/checkout@v4
      - run: swift build

That’s it. Everything else stays the same.

Available Runner Labels

Blaze supports a variety of runner labels for both macOS and Linux. See our hardware documentation for the complete list of available runners, including:

• macOS – Apple Silicon runners with various macOS versions
• Linux ARM64 – Ubuntu runners on ARM64 architecture
• Linux x86_64 – Ubuntu runners on AMD64 architecture
• Compute tier – High-performance runners for demanding workloads

Step 3: Verify Your Build

Push your changes and watch the Actions tab. You’ll see your workflow running on Blaze infrastructure.

git add .github/workflows/ci.yml
git commit -m "chore: migrate to Blaze runners"
git push

Common Questions

Will my existing actions work?

Yes. Blaze runners are fully compatible with the GitHub Actions ecosystem. All actions/* actions, third-party actions, and custom actions work without modification.

What about secrets?

Secrets configured in your GitHub repository settings are automatically available to Blaze runners. No additional configuration needed.

Can I use both GitHub and Blaze runners?

Absolutely. You can use different runners for different jobs in the same workflow:

jobs:
  lint:
    runs-on: ubuntu-latest # GitHub runner

  build-ios:
    runs-on: blaze/macos-15 # Blaze runner

Next Steps

• Learn about runner sizes and pricing
• Check out our hardware specs

Questions? Reach out to support@runblaze.dev.