You are viewing **Develocity Documentation 2026.1**. To view the latest available version of the docs, see [2026.3](https://docs.develocity.ai/2026.3/administration/system-configuration/license-management/). # License Management Manage your Develocity license, including monitoring status, handling expiration events, and performing updates in both online and air-gapped environments. ## License Status & Expiration You can view your current license entitlements, feature sets, and expiration date by navigating to **Administration**  **License**. ### Impact of Expiration If your license expires, Develocity enters a **Read-Only** mode. In this state, the following permissions aren’t granted to any users: * _Publish Build Scan_ * _Read and write Build Cache data_ * _Use Test Distribution_ Existing Build Scan data remains viewable. > [!NOTE] > The _Read Build Cache data_ permission will continue to function as normal for users who have it. However, it won’t be automatically granted to users who had "Read and write Build Cache data". Full functionality will be restored if the Develocity license expiration date is updated (see below), and users' permissions will be restored automatically.  Develocity License Administration Dashboard > [!IMPORTANT] > In some environments, Kubernetes may fail to pull Develocity Docker images or fail to start new instances if the license check remains in a failed state for an extended period. ## Updating Your License The method for updating your license depends on whether your Develocity instance has internet access. ### Online Installations (Automatic) Online instances automatically check the Gradle license server for updates on startup and every hour thereafter. If a license update requires a restart to take effect, a notification is displayed to administrators. For online installations, all that’s needed to avoid expiration is to ensure that your customer success representative has extended your license. There is no need to obtain or install a new license file, as the update will be applied automatically. If the application has failed to start due to license expiration, restart it after your customer success representative has extended your license. The **Administration**  **License** tab can also be used to: * Verify the current license’s information, such as expiration date * Compare the current license and updated license (when an updated license has been downloaded) * Restart Develocity to apply the updated license (when an updated license has been downloaded) * Check whether license checks are functioning properly * Initiate an on-demand license check > [!CAUTION] > If license checks fail consistently for 72 hours, the instance will fail to restart until connectivity is restored or a valid license is applied. ### Airgap Installations (Manual) Airgap instances don’t receive automatic license updates. Follow this sequence to manually update your license. #### 1. Obtain the License Key Contact your **Customer Success representative** to receive your updated license file or key. #### 2. Update the Configuration The license is provided through the `global.license` Helm value, not the unattended configuration file. Update your _values.yaml_ with the new license file contents: ```yaml global: license: file: «develocity.license contents» (1) ``` 1. The contents of the new develocity.license file. Alternatively, keep the license out of values.yaml and pass the file at upgrade time with --set-file global.license.file=./develocity.license, or reference a Kubernetes secret with global.license.secretName. #### 3. Apply the Changes Run `helm upgrade` against your installation to roll out the new license. This applies to both Kubernetes and Standalone installations; the full upgrade commands are shown in the "Changing Configuration Values" sections of the [Kubernetes](https://docs.develocity.ai/2026.1/reference/helm-charts/cluster/#changing_configuration_values) and [Standalone](https://docs.develocity.ai/2026.1/reference/helm-charts/standalone/#changing_configuration_values) Helm chart configuration guides. ## Configure via Helm If you are managing Develocity using a GitOps or automated workflow, note that the license isn’t part of the [Unattended Configuration](https://docs.develocity.ai/2026.1/administration/unattended-configuration/) schema. Manage it as a Helm value instead, either inline in _values.yaml_ (`global.license.file`), as a `--set-file global.license.file` argument, or as a Kubernetes secret referenced with `global.license.secretName`. ### Deployment Templates Download the appropriate YAML template to begin your infrastructure configuration. _For Develocity versions 2025.3 and prior, see the [2025.2 Administration Guide](https://docs.gradle.com/develocity/legacy/helm-admin/2025.2) or the [2025.3 Administration Manual](https://docs.develocity.ai/2025.3/administration/admin-manual/)._

Cluster Deployment	Example template for cluster orchestration. gradle-enterprise-config-schema-15.yaml | SHA256 | ASC | ASC SHA256
Standalone Deployment	Example template for standalone setup. gradle-standalone-config-schema-15.yaml | SHA256 | ASC | ASC SHA256

> [!IMPORTANT] > Pre-deployment Checklist Backup: Export your current settings via Administration Import/export before applying changes. Deployment: After updating your values.yaml, re-deploy using Helm. Impact: This triggers service restarts and may take several minutes to complete. See Unattended Configuration for details. Further details can be found in the "Changing configuration values" sections of the [Standalone](https://docs.develocity.ai/2026.1/reference/helm-charts/standalone/#changing_configuration_values) and [Kubernetes](https://docs.develocity.ai/2026.1/reference/helm-charts/cluster/#changing_configuration_values) Helm chart configuration guides. ## Troubleshooting * **Expiration Mismatch:** If the date in the UI doesn’t match your contract, contact [support.gradle.com](http://support.gradle.com). * **Connectivity:** If online updates fail, verify your [Proxy Settings](https://docs.develocity.ai/2026.1/administration/system-configuration/proxy/). * **Support Bundles:** If license issues persist, generate a [Support Bundle](https://docs.develocity.ai/2026.1/operations/support-and-diagnostics/#support-bundle) for investigation.