Why your GitHub Actions free minutes run out (and how to stop it)
GitHub includes free Actions minutes for private repositories. They go much faster than you'd think, especially on macOS runners. Burnstack started after exactly this kind of surprise bill.
How the free allowance works
Standard GitHub-hosted runners are free for public repositories. For private repositories, each plan includes a monthly allowance of minutes:
| Plan | Included minutes per month |
|---|---|
| GitHub Free | 2,000 |
| GitHub Pro | 3,000 |
| GitHub Team | 3,000 |
| GitHub Enterprise Cloud | 50,000 |
Check GitHub's billing docs for your plan's current numbers. Minutes beyond the allowance are billed per minute unless your budget stops them.
Why macOS minutes disappear
GitHub has historically counted minutes on Windows runners twice and on macOS runners ten times against the allowance (explainer). So 2,000 free minutes is about 200 real macOS minutes. A 10-minute macOS job on every push uses the month's allowance in 20 pushes.
Billing pages show minutes per runner type, but it's easy to miss which ones weigh more. Burnstack counts them with those multipliers, so its warnings come early rather than late.
Ways to cut minutes
- Run macOS and Windows jobs only when needed: on release branches, tags, or with a label, not every push.
- Cancel superseded runs: add a
concurrencygroup withcancel-in-progress: true. - Filter by path: skip CI when only docs change (
paths/paths-ignore). - Cache dependencies: package managers and build caches often halve job time.
- Trim the matrix: test every OS and version on the main branch, a single combination on pull requests.
- Check scheduled workflows: a nightly job on a private repository runs whether anyone's working or not.
- Run checks locally: a pre-push hook that runs lint and tests on your machine costs nothing.
- Set a budget so overage stops at an amount you choose.
Get warned before you run out
Burnstack reads your GitHub billing usage with a read-only token and warns you three ways:
- Burst: 10% of the month's free minutes used in a single day.
- Running low: 75% used.
- Used up: 100% used, or overage being billed.
Alerts arrive as desktop notifications even when the window is closed. Set up the GitHub integration.