Skip to main content

License Management

Upbound Crossplane is available in community and commercial plans for Upbound.

  • Upbound Community Plan lets you run Upbound Crossplane for free and is source-available on GitHub
  • Upbound Standard, Enterprise, and Business Critical are commercial plans that let you create license keys that unlock additional features in Upbound Crossplane
important

To generate a license key for Upbound Crossplane, contact your Upbound account representative.

This guide walks through how to manage a UXP license.

Prerequisites

Before you begin, make sure you have:

  • a running Kubernetes cluster
  • kubectl installed
  • the up CLI installed
  • a valid UXP license provided by Upbound (for Standard plans and above)

Community plan

The Community plan on Upbound lets you run Upbound Crossplane without a license. This lets you use the free core features of Upbound Crossplane.

Enable a development license

To generate a development license for local development on a single-node cluster, use the up CLI:

up uxp license apply --dev

Restrictions

Users can't provide Upbound Crossplane as a commercial Crossplane service to others.

Commercial plans (Standard, Enterprise, Business Critical)

Users who have a commercial plan on Upbound including Standard, Enterprise, and Business Critical may generate and install license keys. These commercial license keys unlock commercial-only features in Upbound Crossplane.

Users who purchased a commercial plan (Standard, Enterprise, and Business Critical) can generate and install license keys.

Commercial features

Commercial licenses unlock the following Upbound Crossplane features:

  • Provider pod autoscaling
  • Function pod scale-to-zero
  • Backup and restore
  • Access to patch releases of Official Providers

These features are unavailable unless a valid license is present.

  • Upon license expiration:
    • The cluster enters a grace period whereby features continue to work. The grace period is 25% of the total license duration. For example, a yearly license has a 3-month grace period, and a monthly license has about a 1-week grace period. During this grace period, the commercial features will continue to function normally. However, you'll notice warnings emitted in Upbound Crossplane that the license's grace period is active.
    • Configuration of commercial features remains unchanged, allowing you to add a new license and continue using commercial features as before expiration.
  • After license expiration and grace period: After the grace period ends, paid features or components get locked down. This means any component checking the license sees that it's truly invalid (expired and grace period ended) and disables its paid features.

Development licenses

When you deploy Upbound Crossplane into a local single-node kind cluster, it automatically receives a temporary license that unlocks commercial features. These development licenses enable local development and testing flows with Upbound Crossplane.

important

This license may not be re-used for production purposes.

Add a license to an Upbound Crossplane cluster

To enable commercial features in an Upbound Crossplane cluster, you need a commercial license.

Connect to your Upbound Crossplane cluster.

Download your license file and apply the license with the up CLI:

up uxp license apply /path/to/license.json

If you don't provide a license key, UXP runs the Community edition.

important

You may not re-use licenses across multiple Upbound Crossplane clusters.

Verify a license

Confirm your license status:

up uxp license show

It should print a result like the following:

Upbound Crossplane License Status:  Valid (The license signature has been successfully verified.)
Created: 2025-07-15 08:30:21 -0400 EDT
Expires: 2025-10-13 08:30:21 -0400 EDT

Plan: standard
Resource Hour Limit: 50000
Operation Limit: 5000
Enabled Features:
- LazyCRDLoading
- ProviderVPA
- BackupRestore

License status information

For a detailed view, use kubectl to return the full resource YAML information:

kubectl get license uxp -o yaml

The status field provides more information about your license entitlements and current usage:

FieldDescription
planThe commercial plan associated with your license (Community, Standard, etc).
expiresAtThe date and time when your license is set to expire.
capacityThe total capacity granted by your license, such as resourceHours and operations.
enabledFeaturesA list of the commercial features unlocked by your license.
usageThe cumulative usage data tracked by the system, including utilization percentages.
conditionsReports the real-time status, including LicenseValid and UsageCompliant conditions.
gracePeriodEndsAtWhen the license grace period ends and the license becomes completely invalid.

For more information on usage metering, review the Usage Metering guide.