Machine Specifications
Cloud Build Machines
Section titled “Cloud Build Machines”RunnerHub provides cloud-hosted build machines running on Apple Silicon Mac hardware (M1/M2/M3 series).
Mac Hardware
Section titled “Mac Hardware”- Processor: Apple Silicon (M1, M2, or M3)
- Cores: 4-8 cores (performance optimized)
- Memory: 8-16GB RAM per concurrent job
- Storage: High-speed SSD (100GB+ available per build)
Operating System
Section titled “Operating System”- macOS: Latest stable version
- Updates: Applied automatically (no downtime)
- Security patches: Installed monthly
- Xcode: Latest stable version
Pre-Installed Software
Section titled “Pre-Installed Software”All RunnerHub build machines come with essential development tools pre-installed and ready to use.
Apple Development Tools
Section titled “Apple Development Tools”| Tool | Version | Notes |
|---|---|---|
| Xcode | Latest stable | Includes iOS SDK, watchOS SDK, tvOS SDK |
| Command Line Tools | Matches Xcode | Compilers, headers, utilities |
| Swift | Matches Xcode | Swift compiler and runtime |
| CocoaPods | Latest | iOS dependency manager |
| Bundler | Latest | Ruby gem manager |
Scripting Languages
Section titled “Scripting Languages”| Language | Version | Notes |
|---|---|---|
| Node.js | LTS (18.x or 20.x) | Latest LTS release |
| npm | Latest | Installed with Node.js |
| Yarn | Latest | JavaScript package manager |
| Python 3 | Latest | System Python 3 installation |
| Ruby | System default | Ruby 2.6 or later |
Build Utilities
Section titled “Build Utilities”| Tool | Purpose |
|---|---|
| Git | Version control |
| curl, wget | Download files |
| jq | JSON processing |
| zip, unzip | Archive tools |
| gzip, gunzip | Compression utilities |
| tar | Archive and compress |
Fastlane & CI Tools
Section titled “Fastlane & CI Tools”| Tool | Purpose |
|---|---|
| Fastlane | iOS/macOS automation |
| xcpretty | xcodebuild formatter |
| xcrun | Xcode utilities |
Homebrew
Section titled “Homebrew”- Available: Yes (read-only access)
- Installation: Cannot install or upgrade packages
- Usage: Query installed tools only
- Custom tools: Install in your pipeline using standard package managers
Machine Availability
Section titled “Machine Availability”Disk Space per Build
Section titled “Disk Space per Build”| Plan | Concurrent Limit | Disk per Build | Notes |
|---|---|---|---|
| Free | 1 | 50GB | Suitable for small-medium projects |
| PAYG | 1 | 50GB | Suitable for small-medium projects |
| Pro | 2 | 50GB | Per concurrent job |
| Business | 3 | 50GB | Per concurrent job |
Disk usage includes:
- Repository clone
- Build artifacts (intermediate files, DerivedData)
- Artifacts (final outputs: .ipa, .dSYM, etc.)
- Cache
Network Bandwidth
Section titled “Network Bandwidth”- Unlimited incoming — Clone repos, download dependencies
- Unlimited outgoing — Upload artifacts, send logs
Resource Limits
Section titled “Resource Limits”Memory per Concurrent Build
Section titled “Memory per Concurrent Build”Each concurrent build has dedicated memory:
| Plan | Per Build | Total Available |
|---|---|---|
| Free | 8GB | 8GB (1 concurrent) |
| PAYG | 8GB | 8GB (1 concurrent) |
| Pro | 8GB | 16GB (2 concurrent) |
| Business | 8GB | 24GB (3 concurrent) |
CPU per Concurrent Build
Section titled “CPU per Concurrent Build”Each concurrent build gets:
- 4+ cores at high priority
- No CPU throttling
- Performance cores prioritized for Xcode builds
Timeout Limits
Section titled “Timeout Limits”| Plan | Max Timeout |
|---|---|
| Free | 30 minutes |
| PAYG | 60 minutes |
| Pro | 90 minutes |
| Business | 120 minutes |
If a build exceeds its timeout, it’s automatically terminated and marked FAILED.
Self-Hosted Agent Specs
Section titled “Self-Hosted Agent Specs”For self-hosted agents, you control the hardware:
Minimum Requirements
Section titled “Minimum Requirements”- Mac mini or equivalent Mac
- 4+ CPU cores
- 8GB+ RAM
- 100GB+ SSD
- macOS Monterey or later
- High-speed internet
Recommended Specs
Section titled “Recommended Specs”| Spec | Recommended | Notes |
|---|---|---|
| CPU Cores | 8+ | More cores = better concurrent performance |
| RAM | 16-32GB | Per concurrent job: 8GB (VMs) minimum |
| Storage | 500GB SSD | For caching and artifacts |
| Network | Gigabit fiber | For fast dependency downloads |
| Uptime | 99%+ | Builds queued while agent is down |
Concurrent Job Guidelines
Section titled “Concurrent Job Guidelines”All jobs run in isolated Tart VMs regardless of host hardware:
| Concurrent Jobs | CPU | RAM | Best For |
|---|---|---|---|
| 1 | 4+ | 8GB | Single developer, testing |
| 2 | 8+ | 24GB+ | Active team |
| 3 | 12+ | 36GB+ | Large team |
Software Versions
Section titled “Software Versions”Xcode & SDKs
Section titled “Xcode & SDKs”Pre-installed Xcode includes:
- iOS SDK: Current and 1-2 previous versions
- macOS SDK: Current and 1-2 previous versions
- watchOS SDK: Current and 1-2 previous versions
- tvOS SDK: Current and 1-2 previous versions
- Swift: Compiler for all supported versions
macOS Compatibility
Section titled “macOS Compatibility”RunnerHub machines can build for:
- iOS: All active versions (currently iOS 13+)
- macOS: All active versions (currently macOS 10.13+)
- watchOS: All active versions (currently watchOS 6+)
- tvOS: All active versions (currently tvOS 13+)
Customization
Section titled “Customization”Self-Hosted Agents
Section titled “Self-Hosted Agents”You can customize self-hosted machines:
- Pre-install additional tools in the base image
- Configure development environments
- Add specialized hardware (GPUs, external drives)
- Install proprietary tools or libraries
Cloud Machines
Section titled “Cloud Machines”Standard cloud machines cannot be customized. For custom environments, consider using self-hosted agents or contact support for enterprise options.
Performance Characteristics
Section titled “Performance Characteristics”Build Performance
Section titled “Build Performance”Typical build times on RunnerHub machines:
| Project Type | Typical Duration |
|---|---|
| Simple Swift package | 3-5 min |
| iOS app (build only) | 5-10 min |
| iOS app (build + tests) | 15-30 min |
| Complex monorepo | 30-60+ min |
These times include:
- Repository clone (5-30s)
- Dependency restoration (via cache)
- Compilation and testing
- Artifact upload
Cache Hit Performance
Section titled “Cache Hit Performance”With caching enabled:
- First build: 20-40% longer (cache is written)
- Subsequent builds: 30-50% faster (cache restored)
Hardware Maintenance
Section titled “Hardware Maintenance”Automatic Updates
Section titled “Automatic Updates”RunnerHub automatically:
- Patches security vulnerabilities
- Updates macOS
- Updates Xcode
- Updates toolchains
These updates happen transparently—no action required.
Machine Replacement
Section titled “Machine Replacement”Machines are replaced periodically:
- No impact on your builds
- Job continuity maintained
- No configuration changes needed
Specifications by Plan
Section titled “Specifications by Plan”| Component | Free | PAYG | Pro | Business |
|---|---|---|---|---|
| Processor | Apple Silicon | Apple Silicon | Apple Silicon | Apple Silicon |
| Memory | 8GB | 8GB | 8GB × 2 | 8GB × 3 |
| Storage per job | 50GB | 50GB | 50GB | 50GB |
| Concurrent | 1 | 1 | 2 | 3 |
| Max timeout | 30 min | 60 min | 90 min | 120 min |
| Pre-installed tools | All | All | All | All |
| Xcode version | Latest | Latest | Latest | Latest |
Q: Can I request a specific macOS version? A: Machines run the latest stable version. For specific versions, use self-hosted agents with isolated execution.
Q: Can I install additional software? A: For cloud machines, no. For self-hosted agents, yes—customize your base machine image or use direct execution.
Q: What if I need more disk space? A: Optimize your builds (reduce artifacts, use caching). For persistent large artifacts, configure external storage or S3 uploads.
Q: Can I access the machine directly? A: Cloud machines: No direct access (security). Self-hosted agents: Full control on your hardware.
Q: How often are machines updated? A: Automatically, with no interruption to your builds. Updates happen transparently.