Skip to main content

Plans & Usage

Understand your plan limits and manage your resource usage.

Instance Plans vs. Platform Plans

This page covers instance plans — the subscription your organization has within the kuploy-cloud platform you use. These plans are defined by your platform operator (tenant).

For platform-level plans that control what the tenant's kuploy-cloud instances can do, see Licensing & Platform Plans.

Available Plans​

Your platform operator configures the available plans. A typical setup includes:

PlanDescription
Default planAutomatically assigned to new organizations
Paid plansHigher tiers with increased resource limits

Plan names, pricing, and limits are defined by your platform operator and may change over time. Check your platform's billing page for the current plan catalog.

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: User-provided domains (e.g., myapp.com)
  • Free Subdomains: Kuploy-provided subdomains (e.g., myapp.kuploy.app)
  • Purchasable Domains: Domains you can buy directly through the platform (see Purchasing a Domain)

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
Build Minutes Tips
  • 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:

  1. Click your profile icon in the top-right
  2. Select Billing
  3. 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​

Your platform may provide a 10% grace period on build minutes to prevent disruption:

  • 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​

  1. Go to Billing
  2. Click Upgrade on your desired plan
  3. Complete payment via Stripe
  4. New limits apply immediately
note

When upgrading mid-cycle, you're charged a prorated amount for the remainder of the billing period.

Downgrading Your Plan​

  1. Go to Billing
  2. Click Manage Subscription
  3. Select a lower plan
  4. Downgrade takes effect at the end of your billing period
caution

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​

  1. Go to Billing
  2. Click Manage Subscription
  3. Click Cancel Subscription
  4. Your plan remains active until the end of the billing period
  5. After expiration, you'll be moved to the default plan

Your apps and data are preserved, but:

  • Resources exceeding the default plan's 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
  1. Go to Billing
  2. Click Manage Subscription or Payment Methods
  3. You'll be redirected to Stripe's secure portal

Invoice History​

View all past invoices:

  1. Go to Billing → Manage Subscription
  2. Click Billing History in the Stripe portal
  3. Download invoices as PDF

Billing Period​

Your billing period is determined by your subscription:

  • Default plan (no Stripe subscription): Falls back to calendar 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 LevelWhat 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​

  1. Go to Billing → Manage Subscription
  2. Click Payment Methods in Stripe portal
  3. Add your card details
  4. Set as default if needed

Failed Payments​

If a payment fails:

  1. You'll receive an email notification
  2. Stripe will retry the payment automatically
  3. Update your payment method if needed
  4. 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.

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 your platform operator for custom 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.

What features are gated by plan?​

Feature availability depends on your platform operator's configuration. Common gated features include:

  • Custom Domains: Typically requires a paid plan
  • Domain Purchasing: Buy domains directly from the platform (Pro/Business plans)
  • Team Members: Higher plans allow more team members
  • Build Minutes: Higher plans include more build time