Create an Account

This guide walks you through creating a RunnerHub account and verifying your email address.

Step 1: Go to the Sign Up Page

1. Navigate to runnerhub.net in your web browser
2. Click the Sign Up button or link
3. You'll see the registration page

Note

RunnerHub is free to try. You start with 500 minutes per month on the Free plan with no payment required.

Step 2: Enter Your Email

On the registration page:

1. Enter your email address
2. Click Continue with email
3. A 6-digit one-time password (OTP) will be sent to your email within seconds

Check your inbox (and spam folder just in case) for the email containing your OTP.

Tip

OTPs are valid for 10 minutes. If it expires, you can request a new one.

Step 3: Verify Your OTP

1. Copy the 6-digit code from your email
2. On the verification page, enter the code digit-by-digit
3. You can also paste the entire code at once
4. Click Verify code

Caution

For security, you can only request a new OTP once per minute. If you don't receive your code, wait a moment before requesting another.

Step 4: Sign Up with OAuth (Optional)

Alternatively, you can skip email verification and sign up directly using your GitHub, GitLab, or Bitbucket account:

1. On the sign-up page, click Continue with GitHub, Continue with GitLab, or Continue with Bitbucket
2. Authorize RunnerHub to access your account (read-only access to repositories)
3. You'll be logged in and taken to dashboard onboarding

Note

OAuth signup skips email verification. Your account email will be synced from your OAuth provider.

Troubleshooting: "Invalid or expired state. Please try again."

If an OAuth sign-in fails with a 400 and this message, the usual cause is two sign-in attempts running at once in the same browser.

Each time you start an OAuth flow, RunnerHub issues a single-use, browser-bound runnerhub_oauth_state cookie. Starting a second attempt overwrites that cookie, so whichever tab you complete second succeeds and the other one fails. Opening the provider button twice, double-clicking it, or leaving an old sign-in tab open all produce this.

Fix: close the extra tabs and start a single sign-in flow again. This is expected behaviour, not a bug — the cookie is what prevents an attacker from feeding you their login link and landing you inside their account.

The same message also appears if you take longer than 5 minutes between clicking the provider button and finishing authorization, since the state expires. Just start again.

Step 5: Set Your Password

If you used email + OTP:

1. After verification, you'll be prompted to set a password
2. Choose a strong password (we recommend 12+ characters)
3. Click Create account
4. You're now signed up and logged in!

What's Next?

Once your account is created:

1. Create a workspace — Your top-level container for apps, team members, and signing credentials (guide →)
2. Add your first app — An app is where your pipeline configuration lives (guide →)
3. Connect a repository — Link your GitHub, GitLab, or Bitbucket repo (guide →)
4. Write your first pipeline — Create .runnerhub/runnerhub.yml and push to trigger a build (guide →)

Tip

Your email address and password can be managed later in Settings → Password within the dashboard.