About billing for GitHub Packages
Note that GitHub may apply a temporary authorization hold for the value of the usage-based costs in advance, which will appear as a pending charge in your account's payment method.
GitHub Packages usage is free for public packages. For private packages, each account on GitHub receives a quota of free storage and data transfer, depending on the account's plan. Any usage beyond the included amounts is controlled by budgets.
If you are an organization or enterprise owner, you can connect an Azure Subscription ID to your organization or enterprise account to enable and pay for GitHub Packages usage beyond the amounts included with your account. For more information, see Connecting an Azure subscription.
Data transfer resets every month, while storage usage does not.
Plan | Storage | Data transfer (per month) |
---|---|---|
GitHub Free | 500MB | 1GB |
GitHub Pro | 2GB | 10GB |
GitHub Free for organizations | 500MB | 1GB |
GitHub Team | 2GB | 10GB |
GitHub Enterprise Cloud | 50GB | 100GB |
All data transferred out, when triggered by GitHub Actions, and data transferred in from any source is free. We determine you are downloading packages using GitHub Actions when you log in to GitHub Packages using a GITHUB_TOKEN
.
Hosted | Self-Hosted | |
---|---|---|
Access using a GITHUB_TOKEN | Free | Free |
Access using a personal access token | Free | Paid |
Storage usage is shared with build artifacts produced by GitHub Actions for repositories owned by your account. For more information, see About billing for GitHub Actions.
GitHub charges usage to the account that owns the repository where the package is published. If your account's usage surpasses these limits and you have a valid payment method on file, you will pay $0.008 USD per GB of storage per day and $0.50 USD per GB of data transfer.
For example, if your organization uses GitHub Team, allows unlimited spending, uses 150GB of storage, and has 50GB of data transfer out during a month, the organization would use 148GB for storage and 40GB for data transfer for that month beyond their included quota. The additional storage would cost $0.008 USD per GB per day or approximately $37 USD for a 31-day month. The additional data transfer would cost $0.50 USD per GB or $20 USD.
To estimate the costs for consumptive services, you can use the GitHub pricing calculator.
At the end of the month, GitHub rounds your data transfer to the nearest GB.
GitHub calculates your storage usage for each month based on hourly usage per GB during that month. For example, if you use 3 GB of storage for 10 days of March and 12 GB for 21 days of March, your storage usage would be:
- 3 GB x 10 days x (24 hours per day) = 720 GB-Hours
- 12 GB x 21 days x (24 hours per day) = 6,048 GB-Hours
- 720 GB-Hours + 6,048 GB-Hours = 6,768 total GB-Hours
- 6,768 GB-Hours / (744 hours per month) = 9.0967 GB-Months
At the end of the month, GitHub rounds your storage to the nearest MB. Therefore, your storage usage for March would be 9.097 GB.
You can also use this calculation in the middle of a billing cycle, to estimate what your total usage might be for the month. For example, if you have an organization that uses GitHub Team, which provides 2 GB of free storage, and you use 0 GB for the first 5 days of April, 1.5 GB for the following 10 days, and you plan to use 3 GB for the last 15 days of the billing cycle, your projected storage usage for the month would be:
- 0 GB x 5 days x (24 hours per day) = 0 GB-Hours
- 0.5 GB x 10 days x (24 hours per day) = 120 GB-Hours
- 3 GB x 15 days x (24 hours per day) = 1080 GB-Hours
- 0 GB-Hours + 120 GB-Hours + 1080 GB-Hours = 1200 total GB-Hours
- 1200 GB-Hours / (744 hours per month) = 1.6 GB-Months
The projected 1.6 GB of storage usage for the month would not exceed your 2 GB limit, even though your actual storage amount briefly exceeded 2 GB.
Your GitHub Packages usage shares your account's existing billing date, payment method, and receipt. To view all the subscriptions for your account on GitHub, see About the billing cycle.
You must manage billing settings and paid features for each of your accounts separately. You can switch between settings for your personal account, organization accounts, and enterprise accounts using the context switcher on each settings page. See About billing on GitHub.
Managing your budget for GitHub Packages
If your account does not have a valid payment method on file, usage is blocked once you use up your quota.
By default, if you have a valid payment method on file, spending is limited to $0 USD until you set a budget. You can set and manage a budget to limit spending for a product or SKU. See Using budgets to control spending on metered products.