Frequently Asked Questions

How do I create a RunnerHub account? Visit app.runnerhub.net and click “Sign Up”. You can sign up with your email (verified via OTP) or OAuth (GitHub, GitLab, Bitbucket). See the account creation guide for detailed steps.

What payment information do you need at signup? Nothing! You start with 500 free minutes per month on the Free tier. No credit card is required. When you’re ready to upgrade, you can add payment information in your workspace billing settings.

Can I use one account for multiple workspaces? Yes. You can create multiple workspaces under one account, each with separate billing and team members. This is useful if you manage multiple companies or business units.

Workspaces & Apps

What’s the difference between a workspace and an app? A workspace is your top-level container—it holds multiple apps, team members, signing credentials, and variables. An app represents a single project (iOS, macOS, Android, Flutter, or React Native). Most teams have one workspace with one or more apps inside it.

Can I rename or move an app between workspaces? You can rename an app in App Settings. Moving an app between workspaces is not currently supported, but you can duplicate an app’s configuration and create a new one in a different workspace.

What happens if I delete a workspace? Deleting a workspace will delete all apps, pipelines, build history, and team members associated with it. This action cannot be undone. Proceed with care.

Repositories & Webhooks

Which Git providers are supported? GitHub, GitLab, and Bitbucket are fully supported. We use OAuth for GitLab and Bitbucket, and the official GitHub App for GitHub.

What happens if I disconnect a repository? Disconnecting stops webhook deliveries, but your build history is preserved. You can reconnect anytime without losing data.

Do I need to manually create webhooks? No. RunnerHub automatically creates webhooks when you connect a repository. You don’t need to set anything up manually (though you can view/manage webhooks in your Git provider’s settings).

Can I use RunnerHub with private repositories? Yes. When you authorize GitHub/GitLab/Bitbucket, you grant RunnerHub access to your private repos. The app uses secure OAuth credentials and never exposes your code to unnecessary services.

My repository is not showing in the connection list. What’s wrong?

GitHub: Verify the RunnerHub GitHub App is installed on your account/organization and the repository is selected in the app settings
GitLab/Bitbucket: Check that you’re viewing the correct group/workspace and have admin access

Platforms & Languages

What platforms are supported? iOS, macOS, Android, Flutter, and React Native are all fully supported with code signing, caching, and deploy integrations.

Can I build Android or Flutter apps? Yes. Android and Flutter platforms are fully supported. See the Android and Flutter quick-start guides for setup instructions.

What about Windows or Linux apps? RunnerHub is specialized for Apple ecosystem builds. Windows and Linux are not supported.

Do you support Fastlane? Yes, absolutely. Fastlane is fully supported and many of our users rely on it. Just add gem install fastlane as a step in your pipeline. See the Pipeline Cookbook for Fastlane examples.

Can I use CocoaPods, SPM, and other dependency managers? Yes. CocoaPods, Swift Package Manager, Carthage, and other tools work as normal. Dependencies are cached automatically between builds for faster turnarounds.

Pricing & Billing

Is RunnerHub free? Yes. The Free tier gives you 500 minutes per month at no cost. Upgrade to Pay-as-you-go, Pro, or Business when you need more capacity, automatic code signing, or team collaboration.

How does Pay-as-you-go pricing work? You pay $0.055 per minute used beyond your included monthly quota. It’s charged to your card on the 1st of each month. No commitments, no overage surprises—just pay for what you use.

What’s included in each plan?

Feature	Free	PAYG	Pro	Business
Monthly minutes	500	Overage	5,000	Unlimited
Automatic code signing	❌	✓	✓	✓
Team members	❌	✓	✓	✓
Workspace variables	✓	✓	✓	✓
API access	✓	✓	✓	✓
Cloud YAML	✓	✓	✓	✓

See Pricing & Billing for the full comparison.

Can I switch plans? Yes. You can upgrade or downgrade anytime. Upgrades take effect immediately. Downgrades take effect at the start of your next billing period.

Do you offer discounts for annual billing? Contact our sales team at sales@runnerhub.net for custom pricing and discounts.

Code Signing

Do I need to manage signing certificates myself? On Free tier: Yes, you’ll manually upload certificates and provisioning profiles. On PAYG+ plans: No, RunnerHub handles signing automatically. See the Apple code signing guide.

Does RunnerHub replace Fastlane Match? Largely yes, though Fastlane is still fully supported if you prefer it. RunnerHub’s automatic signing removes the need to maintain a Git repo of certificates or manage Keychain access.

Can I store multiple signing credentials? Yes. At the workspace level, you can store multiple Apple API keys and certificates. Each app can choose which credentials to use.

Is my Apple API key secure? Yes. API keys are encrypted at rest in our database. They’re only decrypted on the agent when needed for signing, and never logged or exposed. All credentials are encrypted at rest and only decrypted on the build agent when needed.

Builds & Pipelines

What’s the timeout for a build? Build timeouts depend on your plan: Free (30 min), PAYG (60 min), Pro (90 min), Business (120 min). If your build exceeds its timeout, it will be automatically terminated. See Pricing for details.

Can I run multiple builds in parallel? Concurrent builds depend on your plan: Free and PAYG include 1 concurrent build, Pro includes 2, and Business includes 3. Builds are queued and run as capacity becomes available. See Pricing for details.

Can I cancel a running build? Yes. In the dashboard, click the running build and hit the Cancel button. The current step will be stopped immediately.

What if my build fails? Can I re-run it? Yes. Click the failed build in your dashboard, then click Re-run. This triggers a new build with the same commit SHA.

Are environment variables secret? Yes. Variables marked as secret are:

Not shown in dashboard UI after creation
Not logged in build output
Only decrypted when injected into the build environment
Not visible in git history

Hardware & Infrastructure

What Mac hardware runs my builds? RunnerHub uses dedicated Mac mini instances. Each workspace gets an isolated Mac mini (in VM mode) or uses a shared directory on a Mac mini (in directory mode). Builds do not share resources with other customers.

How fast are the Macs? Mac minis are equipped with the latest Apple Silicon (M-series) chips with 8+ cores and 16+ GB RAM. Build performance is excellent, with fast cloning, compilation, and artifact transfer.

Can I choose between Intel and Apple Silicon? Currently, all RunnerHub agents use Apple Silicon (M-series). Intel support is not available.

Can I customize hardware (more RAM, faster CPU, etc.)? Custom hardware configurations are available on Enterprise plans. Contact sales@runnerhub.net for details.

Teams & Collaboration

Can I invite team members? Yes, on PAYG+ plans. Go to Workspace Settings → Team & Members and invite colleagues. You can assign roles: Owner, Admin, Member, or Viewer.

What’s the difference between roles?

Owner: Full control — manages billing, team, configuration, and all workspace resources
Admin: Currently identical to Member (reserved for future expanded permissions)
Member: Can view builds, cancel/rerun jobs, and download artifacts — cannot modify configuration
Viewer: Read-only access to builds and logs — cannot execute any actions

See the Team Management guide for details.

Can I set per-app permissions? Currently, permissions are workspace-wide. Team members have the same access level across all apps. Per-app permissions are on our roadmap.

Support & Troubleshooting

I have a build that’s not working. Where do I look?

Check the build logs in the dashboard
Search Troubleshooting for your error
See Pipeline Cookbook for examples in your setup
Email support@runnerhub.net with your build ID

Does RunnerHub have an API? Yes. The RunnerHub API lets you query builds, trigger jobs programmatically, and manage your workspace. All authenticated users can access the API.

Can I export my build history? Yes. The API supports querying historical builds. Contact support for bulk export options.

What’s your uptime SLA? We aim for 99.9% uptime. Check status.runnerhub.net for current status and incident reports.

How do I report a bug or request a feature? Email us at feedback@runnerhub.net or use the feedback form in the dashboard. We review all requests and prioritize based on user demand.

Still Have Questions?

If your question isn’t answered here, reach out at support@runnerhub.net — we’re here to help!