> ## Documentation Index > Fetch the complete documentation index at: https://cockroachlabs.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Licensing FAQs export const InternalLink = ({version, path = "", children, ...props}) => { let detectedVersion = version || "stable"; if (typeof window !== 'undefined' && !version) { const match = window.location.pathname.match(/\/docs\/([^/]+)/); if (match) { detectedVersion = match[1]; } } const normalizedPath = path.startsWith("/") ? path.slice(1) : path; return {children} ; }; All versions of CockroachDB starting from the release date of 24.3.0 onward, including patch fixes for versions 23.1-24.2 from that date onward, are made available under the [CockroachDB Software License](https://www.cockroachlabs.com/cockroachdb-software-license/). You can use the dropdown menu at the top of the page to view documentation for other versions. ## License options The table of licenses below refers to options for self-hosted deployments. All Cloud deployments automatically have a valid **Enterprise** license. | Type | Description | | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Enterprise** | This paid license allows usage of all CockroachDB features in accordance with the terms specified in the [CockroachDB Software License][csl]. License must be renewed annually or as negotiated. Support levels available include [Enterprise][support] or [Essential][support]. The type of enterprise license may be set to **Production**, **Pre-production**, or **Development** depending on the environment in which CockroachDB is deployed. | | **Free** | Same functionality as **Enterprise**, but free of charge for businesses with less than \$10M in annual revenue. Clusters will be [throttled](#throttling) after 7 days without sending telemetry. License must be renewed annually. Support level available is Community (i.e., Docs, [Forum][forum], [Slack][slack]). | | **Trial** | A 30 day self-service trial license. Telemetry is required during the trial. Clusters will be [throttled](#throttling) after 7 days without sending telemetry. Telemetry can be disabled once the cluster is upgraded to a paid **Enterprise** license. Support level available during trial is Community (i.e., Docs, [Forum][forum], [Slack][slack]). | | **Evaluation** | Same functionality as **Enterprise**, but may be provided by your sales team if needed for an extended evaluation period. Support level is equivalent to a enterprise license. | Contact Sales if you want to try CockroachDB without telemetry requirements or if you require an extended trial period. Note that: * Clusters with no license key have a 7-day grace period before requiring a license key. This is useful for ephemeral development clusters. * No license key is required for developers running [single-node clusters](#single-node-clusters). ## Obtain a license To obtain a paid **Enterprise** license, contact Sales. Once a license is added to your account, it appears in the [CockroachDB Cloud Console][cloud-console] on the **Organization » Enterprise Licenses** page. This page is only accessible by users with **Organization Admin** permissions. [Sign up for a CockroachDB Cloud Console account](https://cockroachlabs.cloud/signup?experience=enterprise) if you do not already have one. Enterprise licenses generated prior to May 31st 2025 are not visible in the **Enterprise Licenses** page. To obtain an **Enterprise Free** or **Enterprise Trial** license, take the following steps: 1. Point your web browser to the [CockroachDB Cloud Console][cloud-console] and log in as an account with **Organization Admin** permissions. 2. Select **Organization » Enterprise Licenses** from the nav bar dropdown. This will bring you to the **Enterprise Licenses** page, which shows a (possibly empty) list of licenses and their keys, with information about the status of each. 3. Click the **Create License** button. This will bring you to a page called **Get started with CockroachDB Enterprise**. 4. On this page, you will create an **Enterprise Trial** license or an **Enterprise Free** license. 1. To create an **Enterprise Trial** license: 1. Fill in the form with the required information. 2. Click the **Continue** button. 3. Select the checkbox to agree to the Terms & Conditions of the [CockroachDB Software License][csl]. 4. Click the **Generate License Key** button. You will be redirected to the **Enterprise Licenses** page, where you can [start using the key](#set-a-license). 2. To create an **Enterprise Free** license: 1. Fill in the form with the required information. 2. Toggle the switch called **Find out if my company qualifies for an Enterprise Free license**. 3. Fill out the additional information. 4. Click the **Continue** button. * Note that at this stage, you may not qualify for the **Enterprise Free** license. If so, you will be given an **Enterprise Trial** license. 5. Select the checkbox to agree to the Terms & Conditions of the [CockroachDB Software License][csl]. 6. Click the **Generate License Key** button. You will be redirected to the **Enterprise Licenses** page, where you can [start using the key](#set-a-license). You will not be able to create more than one **Enterprise Trial** license per day. If you try, the UI will prevent you from proceeding, and the following message will be displayed: *A new Enterprise Trial license cannot be created at this time because one was recently created. Tell us more about your intended use to find out if you qualify for an Enterprise Free license, or create a new one after \${DATE}.* For quick local testing of Enterprise features, you can [run a single-node cluster](#single-node-clusters). ## Set a license Start the `cockroach sql` shell. As the `root` user, use the `SET CLUSTER SETTING` statement to set the license key: ```sql theme={"theme":{"light":"catppuccin-mocha","dark":"catppuccin-mocha"}} SET CLUSTER SETTING enterprise.license = 'xxxxxxxxxxxx'; ``` You cannot apply an **Enterprise Trial** license more than once to the same cluster. ## Verify a license To verify a license, open the built-in SQL shell and use the `SHOW CLUSTER SETTING` command to check the license key: ```sql theme={"theme":{"light":"catppuccin-mocha","dark":"catppuccin-mocha"}} SHOW CLUSTER SETTING enterprise.license; ``` ``` enterprise.license +-------------------------------------------+ crl-0-ChB1x... (1 row) ``` The license setting is also logged in the `cockroach.log` on the node where the command is run: ```shell theme={"theme":{"light":"catppuccin-mocha","dark":"catppuccin-mocha"}} cat cockroach.log | grep license ``` ``` I171116 18:11:48.279604 1514 sql/event_log.go:102 [client=[::1]:56357,user=root,n1] Event: "set_cluster_setting", target: 0, info: {SettingName:enterprise.license Value:xxxxxxxxxxxx User:root} ``` ## Monitor for license expiry You can monitor the time until your license expires in the following ways: 1. Prometheus: The `seconds_until_enterprise_license_expiry` metric reports the number of seconds until the license on a cluster expires. It will report `0` if there is no license, and a negative number if the license has already expired. For more information, see Monitoring and Alerting. 2. DB Console: Several license expiration messages may be displayed, depending on the status of your cluster's license. 3. [CockroachDB Cloud Console][cloud-console]: If you have an **Enterprise Free** or **Enterprise Trial** cluster, you will see notifications in the **Enterprise Licenses** section, as well as receive notification emails sent to users with **Organization Admin** permissions. 4. CockroachDB emits log messages when a cluster is at risk of being [throttled](#throttling) due to license expiration or telemetry requirements. The database will also return notices to SQL clients or applications that try to execute transactions. During the transition to the [CockroachDB Software License][csl], expiration behavior (including [throttling](#throttling)) will work as follows depending on your version of CockroachDB. For v23.1.29, v23.2.15, v24.1.7, v24.2.5, and v24.3.0 and later, clusters will behave as described in this documentation. For versions less than or equal to v23.1.28, v23.2.14, v24.1.6, and v24.2.4, the behavior will be as follows: * **Enterprise Trial** and **Enterprise Free** licenses will work as expected when you [set a license](#set-a-license). * However, the expiration behavior will be different. Clusters running these versions won't be [throttled](#throttling); instead, the Enterprise features will immediately stop working at license expiration. ## Renew an expired license To renew an expired **Enterprise** license, contact Sales and then [set](#set-a-license) the new license. To renew an expired **Enterprise Free** license, follow the steps in [Obtain a license](#obtain-a-license). ## FAQs ### Can I host CockroachDB as a service for internal use at my organization? Yes, employees and contractors can use your internal CockroachDB instance as a service, but no people outside of your organization will be able to use it without purchasing a license. ### What constitutes hosting CockroachDB as a service? Hosting CockroachDB as a service means creating an offering that allows third parties (other than your employees and contractors) to operate a database. Specifically, third parties cannot modify table schemas. ### What is throttling and how does it work? When a cluster is being throttled, the number of concurrent open SQL transactions is limited to 5. This will happen in the following cases: * The cluster is not following telemetry requirements. * There is a 7 day grace period for **Enterprise Free** and **Enterprise Trial** clusters to (re)start sending telemetry. This applies when the license is first [added](#set-a-license), or any time there is an interruption in telemetry. * The cluster has an expired [license key](#obtain-a-license); depending on the type of expired license, the cluster will be throttled after the following time periods: * **Enterprise**: Never throttles * **Enterprise Free**: Throttles 30 days after expiration * **Enterprise Trial**: Throttles 7 days after expiration * The cluster was running an earlier version of CockroachDB which supported the license known as "CockroachDB Core" and has just been patch upgraded to a version of CockroachDB which is available under the [CockroachDB Software License][csl]. Such clusters get a 30 day grace period before being throttled to de-risk impact to production environments. If no valid license key is ever entered, the cluster will be throttled 7 days after cluster initialization. Single-node clusters for development use are [not throttled](#single-node-clusters). ### Can I use CockroachDB for academic research? Cockroach Labs encourages non-commercial academic research involving CockroachDB. For such projects, [obtain an **Enterprise Free** license](#obtain-a-license). ### Do government entities qualify for a CockroachDB Enterprise Free license? No, government entities do not qualify for an **Enterprise Free** license. To obtain an **Enterprise Trial** license or paid **Enterprise** license, see [Obtain a license](#obtain-a-license). ### Where can I deploy CockroachDB Enterprise Free licenses? Does it have to be on my own hardware or cloud instance? When using an **Enterprise Free** license, an **Enterprise Free** license can only be used to run CockroachDB on your own on premises hardware or in your own account in the public clouds. If you plan to run CockroachDB in your customer's environment or public cloud instance, you will need an **Enterprise** License. ### Do I need a license key for running a single node cluster? No license key is required for developers running single-node clusters using the following `cockroach` commands: * `cockroach start-single-node` * `cockroach demo` Single-node clusters are not [throttled](#throttling). Generally, single-node clusters used for design, prototyping, testing, or development purposes in non-production, internal development environments do not require a license key. ### Can a company with less than \$10 million in annual revenue use the Enterprise Free license if the aggregate revenue of its parent company and affiliates exceeds this threshold? No, the **Enterprise Free** license is intended solely for organizations whose combined annual revenue, including the parent company and all affiliates, is under \$10 million. If total annual revenues exceed this limit, the affiliate does not qualify for the **Enterprise Free** license. ## See also * [CockroachDB Software License][csl] * [Enterprise support][support] * Contact Sales [csl]: https://www.cockroachlabs.com/cockroachdb-software-license [support]: https://www.cockroachlabs.com/support [forum]: https://forum.cockroachlabs.com [slack]: https://www.cockroachlabs.com/join-community [cloud-console]: https://cockroachlabs.cloud