GitHub Free — Can included Actions minutes run with a $0 hard-stop budget?

[legrangemail-ai]

🏷️ Discussion Type

Question

💬 Feature/Topic Area

Other

Discussion Details

I have a GitHub Free personal account with a private repository.

My billing settings show:

• GitHub Actions budget: US$0.00
• Stop usage when budget limit is reached: Enabled
• Status: "Usage blocked"
• No payment method configured
• Last recorded usage: 7 of 2,000 included Actions minutes
• Last recorded artifact storage: 0 of 500 MB

I want to run one standard GitHub-hosted Ubuntu workflow with a maximum runtime of five minutes, producing a small artifact retained for one day.

Can the workflow use my remaining included Actions minutes and artifact storage while the $0 hard-stop budget is enabled?

If not, how can I use my included free allowance while ensuring that no paid charges are possible?

I do not want to add a payment method or authorize paid usage.

[phlppgdfry]

GitHub distinguishes your included allowance from paid usage. Its documentation says that, without a valid payment method, usage is blocked once the included quota is exhausted. Larger runners require a payment method separately.

With 7 of 2,000 minutes used, the numbers you posted do not indicate that your included minutes are exhausted. However, the “Usage blocked” message means I wouldn't assume the workflow will run, or recommend changing your budget without understanding the block.

Could you share the exact error or annotation from a failed run, and confirm that the repository belongs to the personal account whose allowance you're viewing? Please also include the runs-on value. Those details would help distinguish an allowance issue from a budget or runner restriction without asking you to enable paid usage.

Reference: https://docs.github.com/en/billing/concepts/product-billing/github-actions

[davismountaindaniel-create]

Hi Philippe, Thanks for your reply. Here are the requested run details and error information: - Repository: [Confirm repository owner/location] - Workflow runs-on value: ubuntu-latest - Error / Annotation Message: [Insert exact error message or screenshot details here] Please let me know if you need any further context to help diagnose why the usage shows as blocked despite remaining free allowance. Best regards, Shane-Daniel Davis-King null

…

On Wed, 21 Oct Reiwa 8 at 13:24, PHILIPPE  ***@***.***> wrote: GitHub distinguishes your included allowance from paid usage. Its documentation says that, without a valid payment method, usage is blocked once the included quota is exhausted. Larger runners require a payment method separately. With 7 of 2,000 minutes used, the numbers you posted do not indicate that your included minutes are exhausted. However, the “Usage blocked” message means I wouldn't assume the workflow will run, or recommend changing your budget without understanding the block. Could you share the exact error or annotation from a failed run, and confirm that the repository belongs to the personal account whose allowance you're viewing? Please also include the runs-on value. Those details would help distinguish an allowance issue from a budget or runner restriction without asking you to enable paid usage. Reference: https://docs.github.com/en/billing/concepts/product-billing/github-actions — Reply to this email directly, view it on GitHub <#210874?email_source=notifications&email_token=B3VF3D2AYF34QXPWZXMHRQT5VCTHDA5CNFSNUABIM5UWIORPF5TWS5BNNB2WEL2ENFZWG5LTONUW63SDN5WW2ZLOOQXTCOJQHE3TAMJVUZZGKYLTN5XKU43VMJZWG4TJMJSWJJLFOZSW45FMMZXW65DFOJPWG3DJMNVQ#discussioncomment-19097015>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/B3VF3D52DN4DGFRUYLBIO2D5VCTHDAVCNFSNUABIKJSXA33TNF2G64TZHMZTAMJVG4ZTGNBUHNCGS43DOVZXG2LPNY5TCMJQHEZTQOBYUF3AE> . You are receiving this because you are subscribed to this thread.Message ID: ***@***.*** com>

[phlppgdfry]

Hi Shane-Daniel, thanks for getting back to me! 🙂

The ubuntu-latest detail helps, but the repository and error fields still contain template placeholders ([Confirm ...] and [Insert ...]), so the actual failure information hasn't come through yet.

Could you share:

1. The exact error text from the workflow run's Summary / Annotations. If a run never starts, please say that and paste the message shown when you try to start it.
2. Whether the repository belongs to a personal account or an organization, and whether the remaining allowance you're viewing belongs to that same owner. No need to disclose a private repository name.

Also, the original question was posted by @legrangemail-ai. Are you experiencing the same issue on your own account, or replying on behalf of that account? That will help keep the two situations separate.

Those details should let us narrow this down without changing the $0 budget or adding a payment method.

[Timixx1]

Hi there,
No, the workflow cannot use your remaining free minutes and artifact storage in its current state.
When your spending limit is set strictly to US$0.00 on a private repository without a valid payment method, GitHub's billing engine automatically applies the "Usage blocked" status. This is a protective measure to ensure no billable services are triggered, but it unfortunately completely freezes GitHub Actions—even your included free allowance.
Since you strictly do not want to add a payment method or risk any paid charges, here are the two ways you can successfully run your workflow for free:

1. Make the Repository Public (Recommended)

This is the easiest and most effective workaround.
• Why it works: GitHub Actions and artifact storage are 100% free for public repositories using standard GitHub-hosted runners (like Ubuntu).
• When a repository is public, the billing engine bypasses the $0 budget limit and does not check for a configured payment method.
• How to do it: Go to your repository Settings -> General, scroll down to the Danger Zone, and change the visibility to Public.

2. Use a Self-Hosted Runner

If your repository must absolutely remain private, you can run the workflow on your own local machine or server.
• Why it works: Self-hosted runners do not consume GitHub-hosted Actions minutes, meaning they are entirely free to use in private repositories.
• Note: While the workflow will run, uploading artifacts inside a private repo might still hit the billing block. If you encounter this, you may need to upload your small artifact to an external free cloud service (like Google Drive, AWS S3 free tier, or Dropbox) directly via the script.

Alternative (Safe configuration with a card)

If you decide to keep the repo private and want to use GitHub-hosted runners, the only way to unblock the free minutes is to add a payment method. However, you can make it 100% safe from charges by doing the following:

1. Link a card (you can use a virtual or temporary card with a $0 balance).
2. Set your spending limit to US$1.00 instead of $0.00.
3. Ensure "Stop usage when budget limit is reached" is enabled.
   Because you have 1,993 free minutes left, your 5-minute workflow will strictly consume your free allowance. The $1.00 budget will never be touched unless you completely exhaust all 2,000 free minutes, and even then, your max financial exposure is exactly $1.00.
   Let me know if you would like step-by-step instructions on setting up a self-hosted runner!