Build allowances
Build allowances determine how much build time your DeployHQ account can use each month. When you run deployments with build commands, the time spent building counts toward your monthly allowance.
What Are Build Allowances?
Build allowances are measured in minutes and represent the total amount of build time available to your account each month. Every deployment that uses build commands (such as running npm install, composer install, or custom build scripts) consumes build minutes.
Build Allowances by Package
Different packages include different monthly build allowances:
- Free: 30 minutes per month
- Solo: 200 minutes per month
- Pro: Unlimited
- Business: Unlimited
- Enterprise: Unlimited
How Build Credits Work
DeployHQ manages build allowances through a credit system:
Types of Build Credits
Monthly Credits
- Automatically included with your package
- Renewed every month
- Valid for 1 month from creation
- Reset on your monthly renewal date
Purchased Credits
- Additional build minutes you can purchase
- Valid for 1 year from purchase date
- Can be purchased at any time
- Used after monthly credits are exhausted
Promotional Credits
- Special credits provided through promotions
- May have custom expiration dates
Viewing Your Build Allowances
- Log in to your DeployHQ account
- Navigate to Settings
- Under the Billing section, select Build allowances
You'll see: - Your current available build minutes - Active credits and their expiration dates - Recent build usage - Option to purchase additional minutes
Purchasing Additional Build Minutes
If your package includes limited build minutes, you can purchase additional credits:
Available Purchase Options: - 1,000 minutes - 2,500 minutes - 6,000 minutes - 15,000 minutes
Purchased credits are valid for one year from the date of purchase.
How to Purchase
- Visit Settings > Billing > Build allowances
- Select the amount of minutes you need
- Complete the purchase
- Credits are added to your account immediately
Build Usage Tracking
- Build time is tracked in seconds for precision
- Only actual build execution time counts toward your allowance
- Deployment time (file transfers, server commands) does not count
- You can view detailed usage in your build history
Notifications
DeployHQ will notify you when: - You're approaching your monthly build allowance limit - You've exceeded your monthly allowance - Purchased credits are about to expire - Monthly credits are renewed
Automatic Credit Renewal
Monthly build credits automatically renew 24 hours before they expire, ensuring uninterrupted service for your deployments.
Exceeding Your Allowance
If you exceed your build allowance: - You'll receive warning notifications - Deployments may be queued until credits are available - You can purchase additional credits immediately - Consider upgrading to a package with unlimited builds (Pro or higher)
Unlimited Build Allowances
Pro, Business, and Enterprise packages include unlimited build minutes, meaning you never need to worry about build allowances or purchase additional credits.
Important Notes
- Only deployments using build commands count toward your allowance
- Build time is measured from when the build starts to when it completes
- Failed builds still count toward your allowance
- Unused monthly credits do not roll over to the next month
- Purchased credits remain valid for one year
Need help? If you have questions about your build allowances or need assistance managing your build pipeline, please contact our support team.