# How do I set up a self-hosted macOS runner for GitHub Actions?

> Set up a self-hosted macOS runner for GitHub Actions on a dedicated Mac mini M4: 6 steps from GitHub's docs, $116.10 a month flat.

- URL: https://remotemacmini.com/github-actions-macos-runner/
- Last updated: 2026-11-17
- Publisher: RemoteMacMini (https://remotemacmini.com)

**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 no `sudo`.
- **Labels**: a self-hosted runner gets `self-hosted`, `macOS` and its architecture (`ARM64` on 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.**

1. **Prepare the Mac** — Install Xcode and accept its licence (see the Xcode guide linked below). Builds need it before the first job.
2. **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.
3. **Pick the platform** — Choose macOS and the ARM64 architecture, which matches the Apple M4 and M4 Pro chips.
4. **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.
5. **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.
6. **Run it as a service** — Stop the interactive runner, then run ./svc.sh install, ./svc.sh start and ./svc.sh status in the runner folder. The runner now starts with the Mac.

*Target the runner from a workflow*

```yaml
jobs:
  build:
    runs-on: [self-hosted, macOS, ARM64]
    steps:
      - uses: actions/checkout@v4
      - run: xcodebuild -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 17' test
```

## What does a macOS runner cost per month?

**GitHub-hosted macOS minutes add up fast; a self-hosted Mac costs the same whatever the minutes.**

*Monthly cost of macOS CI minutes on GitHub-hosted runners against a flat RemoteMacMini Mac, prices read 17 November 2026*

| 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 November 17, 2026.*

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](https://remotemacmini.com/guides/how-to-install-xcode-from-the-command-line/ "How do I install Xcode from the command line?").

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](https://remotemacmini.com/vs/aws-ec2-mac/ "How does RemoteMacMini compare with 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](https://remotemacmini.com/xcode-cloud-alternative/ "What is a good alternative to Xcode Cloud?") and the [pricing page](https://remotemacmini.com/pricing/ "How much does a RemoteMacMini Mac cost?") 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

1. [Adding self-hosted runners](https://docs.github.com/en/actions/how-tos/manage-runners/self-hosted-runners/add-runners) — GitHub Docs (read 2026-11-17)
2. [Configuring the self-hosted runner application as a service](https://docs.github.com/en/actions/how-tos/manage-runners/self-hosted-runners/configure-the-application) — GitHub Docs (read 2026-11-17)
3. [Self-hosted runners reference](https://docs.github.com/en/actions/reference/runners/self-hosted-runners) — GitHub Docs (read 2026-11-17)
4. [Using self-hosted runners in a workflow](https://docs.github.com/en/actions/how-tos/manage-runners/self-hosted-runners/use-in-a-workflow) — GitHub Docs (read 2026-11-17)
5. [Actions runner pricing](https://docs.github.com/en/billing/reference/actions-runner-pricing) — GitHub Docs (read 2026-11-17)
6. [Amazon EC2 Mac instances](https://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. [Rent Graft for 12 months](https://remotemacmini.com/app/checkout/?plan=graft&term=12m&from=github-actions-macos-runner&lang=en) · [Rent Canopy for 3 months](https://remotemacmini.com/app/checkout/?plan=canopy&term=3m&from=github-actions-macos-runner&lang=en)

---

RemoteMacMini: RemoteMacMini rents dedicated Apple Mac minis (M4 and M4 Pro) in data centres for building, signing and testing iOS and macOS apps: one whole Mac per customer, reached over SSH and Screen Sharing. Five plans cost $76.50 to $247.49 a month, each 10% under the lowest comparable offer read on 17 November 2026, paid in crypto with no ID document.
