Billing & Plans
Kuploy offers flexible plans to match your needs, from hobby projects to production workloads.
Available Plans
| Feature | Free | Pro | Business |
|---|---|---|---|
| Price | $0/month | $20/month | $100/month |
| Projects | 1 | 5 | 20 |
| Apps | 2 | 10 | 50 |
| Databases | 1 | 5 | 25 |
| Domains | 1 | 10 | 50 |
| Build Minutes | 100/month | 500/month | 2,000/month |
Plan Highlights
Free Plan
Perfect for learning and personal projects:
- Deploy a single project with up to 2 apps
- 100 build minutes per month
- Community support
Pro Plan
For developers and small teams:
- 5 projects with up to 10 apps total
- 500 build minutes per month
- Priority support
- Custom domains
Business Plan
For growing businesses and teams:
- 20 projects with up to 50 apps
- 2,000 build minutes per month
- Premium support
- Advanced features
Understanding Resource Limits
Projects
A project is a logical grouping of related applications. Each project can contain multiple apps, databases, and domains.
Apps
Apps are your deployed applications. Each container or service counts as one app.
Databases
Managed database instances (PostgreSQL, MySQL, Redis, etc.) count toward your database limit.
Domains
Custom domains connected to your apps. Subdomains of a single root domain count as separate domains.
Build Minutes
Build minutes are consumed when Kuploy builds your application from source code. Build time includes:
- Pulling your code from Git
- Installing dependencies
- Building/compiling your application
- Creating the container image
- Pre-built Docker images don't consume build minutes
- Efficient Dockerfiles with proper caching reduce build time
- Failed builds still consume minutes
Viewing Your Usage
Monitor your resource consumption from the Billing page:
- Click your profile icon in the top-right
- Select Billing
- View current usage against your plan limits
The usage dashboard shows:
- Resource counts - Projects, apps, databases, domains used
- Build minutes - Minutes used this billing period
- Progress bars - Visual indicators of limit consumption
- Billing period - Current period start and end dates
┌─────────────────────────────────────────────────────┐
│ Build Minutes │
│ ████████████████████░░░░░░░░░░░░░ 350 / 500 │
│ (70%) │
└─────────────────────────────────────────────────────┘
Build Minutes Grace Period
Kuploy provides a 10% grace period on build minutes to prevent disruption:
| Plan | Included | Grace Buffer | Hard Limit |
|---|---|---|---|
| Free | 100 min | +10 min | 110 min |
| Pro | 500 min | +50 min | 550 min |
| Business | 2,000 min | +200 min | 2,200 min |
- Warning at 80% usage
- Soft limit at 100% - warning notifications sent
- Hard limit at 110% - builds are blocked
When you reach the hard limit, new builds will fail until:
- Your billing period resets, or
- You upgrade to a higher plan
Managing Your Subscription
Upgrading Your Plan
- Go to Billing
- Click Upgrade on your desired plan
- Complete payment via Stripe
- New limits apply immediately
When upgrading mid-cycle, you're charged a prorated amount for the remainder of the billing period.
Downgrading Your Plan
- Go to Billing
- Click Manage Subscription
- Select a lower plan
- Downgrade takes effect at the end of your billing period
Before downgrading, ensure your usage is within the new plan's limits. You may need to delete resources to fit within the lower limits.
Canceling Your Subscription
- Go to Billing
- Click Manage Subscription
- Click Cancel Subscription
- Your plan remains active until the end of the billing period
- After expiration, you'll be on the Free plan
Your apps and data are preserved, but:
- Resources exceeding Free plan limits become read-only
- New deployments are blocked until you're within limits
Billing Portal
Access the Stripe billing portal to:
- Update payment method
- View invoice history
- Download invoices
- Update billing information
- Go to Billing
- Click Manage Subscription or Payment Methods
- You'll be redirected to Stripe's secure portal
Invoice History
View all past invoices:
- Go to Billing → Manage Subscription
- Click Billing History in the Stripe portal
- Download invoices as PDF
Billing Period
Your billing period is determined by your subscription:
- Free plan: Aligned to calendar month (1st to end of month)
- Paid plans: Starts on subscription date (e.g., Jan 15 to Feb 14)
Build minutes reset at the start of each billing period.
What Happens When You Hit Limits
Resource Limits (Projects, Apps, etc.)
When you reach a resource limit:
- You cannot create new resources of that type
- Existing resources continue to function normally
- You'll see an error message when attempting to exceed limits
Error: App limit reached. Your Pro plan allows 10 apps.
Upgrade to Business for up to 50 apps.
Build Minutes Limit
| Usage Level | What Happens |
|---|---|
| 80% | Warning notification sent |
| 100% | Additional warning, approaching hard limit |
| 110% (hard limit) | Builds blocked, notification sent |
Payment Methods
Kuploy accepts:
- Credit cards (Visa, Mastercard, American Express)
- Debit cards
- Some regional payment methods (via Stripe)
Adding a Payment Method
- Go to Billing → Manage Subscription
- Click Payment Methods in Stripe portal
- Add your card details
- Set as default if needed
Failed Payments
If a payment fails:
- You'll receive an email notification
- Stripe will retry the payment automatically
- Update your payment method if needed
- After multiple failures, your subscription may be paused
FAQ
When does my billing period reset?
For paid plans, your billing period starts on the day you subscribed. For example, if you subscribed on January 15th, your period runs from the 15th of each month to the 14th of the next month.
Free plans use calendar months (1st to end of month).
Can I get a refund?
Contact support within 14 days of charge for refund eligibility. Partial refunds may be available for unused time on annual plans.
What happens to my apps if I exceed limits?
Existing apps continue running. You cannot create new apps or deploy updates to apps exceeding your new limits until you're within limits.
Do failed builds count against my minutes?
Yes, build minutes are counted from the start of the build process, regardless of outcome. Optimize your Dockerfiles to reduce build times.
Can I buy additional build minutes?
Currently, upgrading to a higher plan is the only way to get more build minutes. Contact support for custom enterprise plans with higher limits.
How do I view my current usage?
Go to Billing from your profile menu. The usage dashboard shows real-time consumption against your plan limits.