Run your first job

Learn how to run your first job with Blaze.

Prerequisites

Before you begin, make sure you have:

  • A GitHub account or organization
  • A Blaze account (you'll create one in this guide)
  • A GitHub Actions workflow file (or create one)

1. Create a Blaze account

To get started with Blaze, you first need to create an account .

2. Install Blaze GitHub app

For any organization or account you want to use Blaze with, you need to install the Blaze GitHub app . This grants our service permission to add runners to be used by your workflows.

3. Add organization or account to "Allowlist"

After creating an account, you will be redirected to the dashboard. Here, you can add your organization or account handles to the "Allowlist" section. This will let Blaze know that it should spawn runners for those organizations or accounts.

Note: An organization or account must have the Blaze GitHub app installed to be added to the "Allowlist".

4. Update your workflow file

For Blaze to run your workflows, you need to update them to use our runners. In your workflow file, replace the runs-on key with runs-on: blaze/macos-14 or runs-on: blaze/ubuntu-22.04, depending on what type of runner you require. This will tell GitHub to run your job on our infrastructure.

Example Workflow

  name: validate
on: push
jobs:
  # macOS example
  test-macos:
  - runs-on: macos-latest # remove this line
  + runs-on: blaze/macos-14 # add this line
  name: Test macOS
  steps:
    - uses: actions/checkout@v4
  # Linux example
  test-linux:
  - runs-on: ubuntu-latest # remove this line
  + runs-on: blaze/ubuntu-22.04 # add this line
  name: Test Linux
  steps:
    - uses: actions/checkout@v4

You can view the full list of runners here .

Congratulations!

That is all you need to do to get up and running with Blaze for GitHub Actions! Now you can start building your workflows and enjoy the benefits of our high-performance infrastructure.

Purchasing runners

New accounts are given a free trial of 300 macOS minutes and 1000 Linux minutes. After that, you need to purchase runners to continue using our service. You can see our prices on our pricing page and purchase from the dashboard .

Note: You can purchase as many runners as you need. If you need more runners, you can always update your plan later.

Next Steps

Related Topics