Quick answer
How do I set up a self-hosted macOS runner for GitHub Actions?
Open the repository's Settings, then Actions, Runners and New self-hosted runner, pick macOS, and run the download and config commands GitHub shows on the Mac. Then install it as a service with ./svc.sh install. RemoteMacMini rents a Mac mini M4 for this at $116.10 a month (Graft, 24 GB), with no per-minute bill.
In brief
- Registration token: valid for one hour, shown on the New self-hosted runner page.
- Service:
./svc.sh install,./svc.sh start,./svc.sh status; on macOS it runs under launchd and needs nosudo. - Labels: a self-hosted runner gets
self-hosted,macOSand its architecture (ARM64on Apple silicon). - Security: GitHub recommends self-hosted runners for private repositories only.
- Cost: GitHub-hosted macOS runners bill $0.062 a minute (standard); Graft costs $116.10 a month whatever the minutes.
What are the steps to add the runner?
Six steps, following GitHub's "Adding self-hosted runners" page read on 17 November 2026. Steps 4 to 6 run on the Mac over SSH.
Prepare the Mac
Install Xcode and accept its licence (see the Xcode guide linked below). Builds need it before the first job.
Open the runner page
On the repository, click Settings, then Actions, then Runners, then New self-hosted runner. You must own the repository, or be an organization owner or admin.
Pick the platform
Choose macOS and the ARM64 architecture, which matches the Apple M4 and M4 Pro chips.
Download the runner
In an SSH session on the Mac, run the download and extract commands exactly as GitHub shows them; they name the current runner version.
Register it
Run the config script with the repository URL and the token GitHub shows. The token expires after one hour, so do this right away.
Run it as a service
Stop the interactive runner, then run
./svc.sh install,./svc.sh startand./svc.sh statusin the runner folder. The runner now starts with the Mac.
jobs:
build:
runs-on: [self-hosted, macOS, ARM64]
steps:
- uses: actions/checkout@v4
- run: xcodebuild -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 17' testWhat does a macOS runner cost per month?
GitHub-hosted macOS minutes add up fast; a self-hosted Mac costs the same whatever the minutes.
| Runner | Price | 6,000 minutes (100 h) | 30,000 minutes (500 h) |
|---|---|---|---|
| GitHub-hosted macOS, standard (3 or 4 cores) | $0.062 a minute | $372 | $1,860 |
| GitHub-hosted macOS, M2 Pro 5-core | $0.102 a minute | $612 | $3,060 |
| AWS EC2 mac-m4 host (M4, 24 GB) | $1.23 an hour, 24-hour minimum | $123 | $615 |
| RemoteMacMini Graft (M4, 24 GB, 512 GB) | $116.10 a month | $116.10 | $116.10 |
Prices checked on
Totals are RemoteMacMini's arithmetic from the published unit prices. An AWS host bills from allocation to release, not per job, and EBS storage is billed apart.
Is a self-hosted runner safe on a public repository?
GitHub advises against it. Its documentation says forks of a public repository can run dangerous code on the runner by opening a pull request. Keep a RemoteMacMini runner on private repositories, or require approval before fork workflows run.
A rented Mac is a single machine that keeps its state between jobs. Clean the workspace in each job, keep signing keys in the keychain of the runner's user only, and never print secrets in logs. No backups are included: keep source code in a remote repository and copy anything that matters off the Mac.
Which Mac does a GitHub Actions runner need?
GitHub's floor is low; Xcode sets the real one. GitHub's reference page, read on 17 November 2026, lists macOS 11.0 or later on x64 and ARM64 (ARM64 marked as public preview there), plus outbound HTTPS on port 443. A RemoteMacMini Mac ships with macOS 26 Tahoe or 15 Sequoia, and its public IPv4 reaches GitHub directly. Install Xcode before the first job with the Xcode command-line guide.
According to RemoteMacMini's survey of 17 November 2026, an M4 with 24 GB cost $129 a month at MyRemoteMac (excluding tax), $249 at MacStadium and $897.90 for 730 hours at AWS (RemoteMacMini vs AWS EC2 Mac). Graft costs $116.10, or $102.17 a month on 12 months. Canopy (M4 Pro · 64 GB · 1 TB) suits several runners side by side. The Xcode Cloud comparison and the pricing page give the full picture.
Self-hosted macOS runners: common questions
Does the runner need a public port open on the Mac?
No. The runner connects out to GitHub over HTTPS on port 443, so no inbound port is needed beyond the SSH you use to manage the Mac.
Can one Mac serve several repositories?
Yes, by registering it at the organization level, or by installing one runner folder per repository. Mind the memory: two Xcode builds at once need a larger plan such as Canopy.
What happens if the registration token expires?
Generate a new one from the New self-hosted runner page. GitHub's token is valid for one hour.
Does the runner survive a reboot?
Yes once installed with ./svc.sh install: on macOS the service runs under launchd and starts again with the Mac.
Does RemoteMacMini offer an API to create runner Macs on demand?
No. RemoteMacMini rents Mac minis only: no Mac Studio, no M4 Max, no M6 yet, no iPhone or iPad attached to the Mac, no hourly billing and no API to create Macs. Each Mac is prepared by a person within 24 hours, so plan runners ahead.
Verdict
- A self-hosted runner on a dedicated Mac pays off once GitHub-hosted macOS minutes pass a few thousand a month.
- RemoteMacMini's Graft at $116.10 a month runs one pipeline on private repositories with caches kept between jobs.
Sources (6)
- Adding self-hosted runners — GitHub Docs (read 2026-11-17)
- Configuring the self-hosted runner application as a service — GitHub Docs (read 2026-11-17)
- Self-hosted runners reference — GitHub Docs (read 2026-11-17)
- Using self-hosted runners in a workflow — GitHub Docs (read 2026-11-17)
- Actions runner pricing — GitHub Docs (read 2026-11-17)
- Amazon EC2 Mac instances aws.amazon.com/ec2/instance-types/mac — Amazon Web Services (read 2026-11-17)
A macOS runner with no minute meter
Graft: Apple M4, 10-core CPU, 10-core GPU, 24 GB, 512 GB SSD, $116.10 a month, paid in BTC, USDT, USDC, ETH, SOL, LTC, XMR.