Machine Specifications

Cloud Build Machines

RunnerHub provides cloud-hosted build machines running on Apple Silicon Mac hardware (M1/M2/M3 series).

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

macOS: Latest stable version
Updates: Images are periodically rebuilt with security and platform updates by the RunnerHub engineering team
Security patches: Installed via periodic image updates
Xcode: Latest stable version

Pre-Installed Software

All RunnerHub build machines come with essential development tools pre-installed and ready to use.

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

| Language | Version | Notes | |----------|---------|-------| | Node.js | Version varies by golden image | Node 22 on Xcode 16.x images, Node 24 on Xcode 26.x images. Activated via nodenv when you set environment.node. | | npm | Latest for Node version | Installed with Node.js | | Yarn | Latest | JavaScript package manager | | Python 3 | Latest | System Python 3 installation | | Ruby | Managed via rbenv | Pre-built versions vary by golden image (e.g., 3.3.11 / 3.4.9 / 4.0.2). To pin a specific version, commit a .ruby-version file to your repository root — rbenv activates it automatically. |

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

| Tool | Purpose | |------|---------| | Fastlane | iOS/macOS automation | | xcpretty | xcodebuild formatter | | xcrun | Xcode utilities |

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

Disk Space per Build

| Plan | Concurrent Limit | Disk per Build | Notes | |------|-----------------|-----------------|-------| | Free | 1 | 100GB | Suitable for small-medium projects | | PAYG | 1 | 100GB | Suitable for small-medium projects | | Pro | 2 | 100GB | Per concurrent job | | Business | 3 | 100GB | Per concurrent job |

Disk usage includes:

Repository clone
Build artifacts (intermediate files, DerivedData)
Artifacts (final outputs: .ipa, .dSYM, etc.)
Cache

Network Bandwidth

Unlimited incoming — Clone repos, download dependencies
Unlimited outgoing — Upload artifacts, send logs

Resource Limits

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

Each concurrent build gets:

4+ cores at high priority
No CPU throttling
Performance cores prioritized for Xcode builds

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 its status is set to TIMEOUT.

Self-Hosted Agent Specs

For self-hosted agents, you control the hardware:

Minimum Requirements

Mac mini or equivalent Mac
4+ CPU cores
8GB+ RAM
100GB+ SSD
macOS Monterey or later
High-speed internet

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

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

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

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

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

Standard cloud machines cannot be customized. For custom environments, consider using self-hosted agents or contact support for enterprise options.

Performance Characteristics

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

With caching enabled:

First build: 20-40% longer (cache is written)
Subsequent builds: 30-50% faster (cache restored)

Hardware Maintenance

Automatic Updates

RunnerHub automatically:

Patches security vulnerabilities
Updates macOS
Updates Xcode
Updates toolchains

These updates happen transparently—no action required.

Machine Replacement

Machines are replaced periodically:

No impact on your builds
Job continuity maintained
No configuration changes needed

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 | 100GB | 100GB | 100GB | 100GB | | 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 |

FAQs

Q: Can I request a specific macOS version? A: Machines run the latest stable version. For specific versions, use self-hosted agents where you control the golden VM image.

Q: Can I install additional software? A: For cloud machines, no. For self-hosted agents, yes—customize your golden VM image (all jobs still run in ephemeral Tart VMs).

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.