Grafana Enterprise license on Grafana Labs

Activate an Enterprise license

Sat, 04 Apr 2026 12:26:57 +0000

Activate an Enterprise license

Follow these steps to activate your Grafana Enterprise license:

Step 1. Download your license file

To download your Grafana Enterprise license:

Sign in to your Grafana Cloud account.
Go to My Account and select an organization from the drop-down menu at the top left of the page. On the Overview page for each organization, you can see a section for Grafana Enterprise licenses. Click Details next to a license.
At the bottom of the license details page, select Download token to download the license.jwt file that contains your license.

Step 2. Add your license to a Grafana instance

There is more than one way to add the license to a Grafana instance:

Upload the license file via the Grafana server administrator page

This is the preferred option for single instance installations of Grafana Enterprise.

Sign in as a Grafana server administrator.
Navigate to Server Admin > Upgrade within Grafana.
Click Upload license token file.
Select your license file, and upload it.

Put the `license.jwt` file into the data directory of Grafana

On Linux systems, the data directory is usually at /var/lib/grafana.

You can also configure a custom location for the license file using the grafana.ini setting:

[enterprise]
license_path = /company/secrets/license.jwt

This setting can also be set with an environment variable, which is useful if you’re running Grafana with Docker and have a custom volume where you have placed the license file. In this case, set the environment variable GF_ENTERPRISE_LICENSE_PATH to point to the location of your license file.

Set the content of the license file as a configuration option

You can add a license by pasting the content of the license.jwt to the grafana.ini configuration file:

[enterprise]
license_text = eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0aGlzIjoiaXMiLCJub3QiOiJhIiwidmFsaWQiOiJsaWNlbnNlIn0.bxDzxIoJlYMwiEYKYT_l2s42z0Y30tY-6KKoyz9RuLE

This option can be set using the GF_ENTERPRISE_LICENSE_TEXT environment variable.

Step 3. Ensure that the license file’s root URL matches the root_url configuration option

Update the root_url in your configuration. It should be the URL that users type in their browsers to access the frontend, not the node hostname(s).

This is important, because as part of the validation checks at startup, Grafana compares the license URL to the root_url in your configuration.

In your configuration file:

[server]
root_url = https://grafana.example.com/

Or with an environment variable:

GF_SERVER_ROOT_URL=https://grafana.example.com/

Step 4. Restart Grafana

To finalize the installation of Grafana Enterprise, restart Grafana to enable all Grafana Enterprise features. Refer to restart Grafana for more information.

License expiration

Sat, 04 Apr 2026 12:26:57 +0000

License expiration

If your license has expired, most of Grafana keeps working as normal. Some enterprise functionality stops or runs with reduced functionality and Grafana displays a banner informing the users that Grafana is running on an expired license. Your Grafana admin needs to upload a new license file to restore full functionality.

Replace your license as soon as possible. Running Grafana Enterprise with an expired license is unsupported and can lead to unexpected consequences.

Update your license

Locate your current license.jwt file. In a standard installation it is stored inside the Grafana data directory, which on a typical Linux installation is in /var/lib/grafana/data. This location might be overridden in the ini file Configuration.
ini
```
[enterprise]
license_path = /path/to/your/license.jwt
```
The configuration file’s location may also be overridden by the GF_ENTERPRISE_LICENSE_PATH environment variable.
Log in to your Grafana Cloud Account and make sure you’re in the correct organization in the dropdown at the top of the page.
Under the Grafana Enterprise section in the menu bar to the left, choose licenses and download the currently valid license with which you want to run Grafana. If you cannot see a valid license on Grafana.com, please contact your account manager at Grafana Labs to renew your subscription.
Replace the current license.jwt-file with the one you’ve just downloaded.
Restart Grafana.

If your license expires

If your Grafana Enterprise license expires, you can expect the following changes in feature behavior.

Data source permissions

Your current data source permissions will keep working as expected, but you’ll be unable to add new data source permissions until the license has been renewed.

LDAP authentication

LDAP synchronization is not affected by an expired license.
Team sync debugging is unavailable.

SAML authentication

SAML authentication is not affected by an expired license.

Reporting

You’re unable to configure new reports or generate previews.
Existing reports continue to be sent.

Enterprise plugins

Enterprise plugins might stop working.

White labeling

The white labeling feature is turned off, meaning that any white labeling options will not have any effect.

Usage insights

Exporting usage insights logs to Loki will be turned off for licenses expired for more than 7 days.

All the other usage insights features are turned off as soon as the license expires, meaning that you will not be able to see dashboard usage, presence indicators, or use improved search. Grafana continues to collect usage data and you will have access to it as soon as you update your license.

Vault integration

Vault integration is not affected by an expired license.

Auditing

Auditing is not affected by an expired license.

License restrictions

The concurrent session limit remains active for seven days after the expiration date, after which it will be turned off.

The active users limit is turned off immediately.

Settings updates at runtime

Settings updates at runtime are not affected by an expired license.

License restrictions

Sat, 04 Apr 2026 12:26:57 +0000

Understanding Grafana Enterprise licensing

When you become a Grafana Enterprise customer, you receive a license that governs your use of Grafana Enterprise.

You either have:

tiered licensing, or
combined licensing

To understand which license type you have, refer to Determine the number of active users for each licensed role.

Tiered licensing

Tiered licensing defines dashboard viewers, and dashboard editors and administrators, as two distinct user types that each have their own user limit.

For example, your license might include 300 viewers and 50 editors or administrators. Although editors and administrators have separate permissions and can do different things, Grafana counts them together as a single licensed role.

Active users limit

Your Grafana license includes a maximum number of Viewer and Editor/Admin active users. For example, your license can include a maximum of 500 viewers and 100 editor/admins.

An active user is a user who has signed in to Grafana within the last 30 days. This is a rolling window that is updated daily.
When you reach the number of maximum active viewers or editor/admins, only currently active users can sign in; new users and non-active users cannot sign in when you reach the limit.
Grafana applies sign-in restrictions separately for viewers and editor/admins. If your Grafana license reaches its limit of active viewers but not its limit of active editor/ddmins, new editors and admins can still sign in.
The number of dashboards that a user can view or edit, and the number of organizations that they can access does not affect the active user count. A user with editor permissions for many dashboards across many different organizations counts as one editor.
A license limit banner appears to administrators when Grafana reaches its active user limit; editors and viewers do not see the banner. To change user roles to make better use of your licenses, refer to Optimize your tiered license.

Permission domains

You can assign role permissions globally and restrict access to a specific dashboard or set of dashboards.

Organization permissions: When you create a user, you select a role on the user details page. Your selection applies to all Grafana dashboards within the Organization. For example, a user with the viewer role can see all dashboards, but cannot create or edit dashboards. For more information about user roles and permissions, refer to Organization roles.

Dashboard permissions: You can also assign permissions to dashboards or groups (folders) of dashboards. For example, you might want a viewer to also have editor permissions for a specific dashboard. While that user can see all dashboards, they can only update one of them. For more information about dashboard permissions, refer to Dashboard and Folder Permissions.

When you grant editor/admin dashboard permissions to a viewer, the editor/admin active-user count increases by one as shown on the Utilization panel of the Statistics and licensing page, and the user’s licensed role changes to editor/admin.

The editor/admin count increases because the user can edit and save a dashboard.

Grant dashboard edit without save permissions

You can grant viewers the ability to edit but not save a dashboard. This setting is useful when you have users that want to explore dashboards, but only need the generated view temporarily and do not require an editor/admin license.

This setting does not affect viewers’ license role billing.

To grant dashboard edit without save permissions:

Open the grafana.ini file that contains default configurations.

The name and location of the file depends on your installation. For information about locating the default configurations file, refer to Configuration.
Change the viewers-can-edit setting to true.
Restart Grafana Enterprise.

Determine the number of active users for each licensed role

Because you can assign a user global permissions while also enhancing (or limiting) their access to specific dashboards, it might be helpful for you to periodically check license counts.

To determine the number of active users for each licensed role:

Sign in to Grafana Enterprise as a System Administrator.
Click Server Admin (the shield icon).
Click Statistics and licensing.
Review the role utilization count on the Utilization panel.

Utilization data updates when the user signs back in to Grafana after you change their permissions.

Optimize your tiered license

Grafana counts viewer users separately from editor/admin users. If you reach the limit imposed by your license for either of these user types, use the following techniques to make optimum use of the licenses you purchased.

Review and update organization permissions. You can modify organization permissions to reduce the count of one type of user. For example, if you reach the limit of editor/admin users, assign viewer permissions to one (or more) editor/admin users who agree to read-only access to dashboards. The license count updates when a user signs back in to Grafana.
Review and update dashboard permissions. Because viewers can also count toward editor/admin usage, if they are granted access to edit specific dashboards, review your dashboard permissions and adjust accordingly. Remove editor or admin permissions where necessary.
Delete users. Review the number of users you have for each type of permission and remove inactive users. Removing users immediately frees up space for new users.

When you delete a user you also delete their preferences, dashboard and folder permissions, and references to that user from the dashboard versions they have updated.

Users who are synced via SAML, Oauth, or LDAP will also lose these attributes.

Update user permissions for dashboards

You can change the access a user has to specific dashboards. For billing purposes, Grafana charges for the highest level permission assigned to the user. For example, if you assign editor/admin dashboard permissions to a viewer user, Grafana counts that user as an editor/admin.

To change user permissions for dashboards:

Sign in to Grafana as a system administrator.
Hover your mouse over Server Admin (the shield icon) and click Statistics and licensing.
In the Dashboard and Folder Permissions area, click the dashboard in the **Resource title (URL) column.

The Permission page opens.
Use the dropdown list to select a role.

The next time the user signs in, the Utilization panel on the Statistics and licensing page displays updated data.

Combined licensing

As of Grafana Enterprise Version 8.3, you can purchase (or transition to) combined licensing. With combined licensing, you purchase a specific number of users, and you are free to distribute those users across all roles, in any combination. For example, if you purchase 150 licenses, you can have 20 admins, 70 editors, and 60 viewers, or you can have 10 admins, 100 editors, and 40 viewers. This change reduces license complexity.

Transition to combined license model

To transition from the tiered licensing model to the combined license model, contact your Grafana account team and request to switch to combined user pricing. Once you update your contract with the account team, they will issue you a new license token. For instructions about how to update your license, refer to Activate an Enterprise license.

After you apply the token, Grafana Enterprise resets your license and updates the user counts on the Utilization panel.

If you are running Grafana Enterprise 8.2 or earlier, the license grants you the total number of licensed users for each user type.

For example, if your current license includes 60 viewers and 40 dditor/admins, the new license includes 100 viewers and 100 editor/admins. Grafana Enterprise 8.3 removes the distinction between viewers and editor/admins as shown on the Utilization panel.

Before you upgrade to Grafana 8.3, ensure that the total number of active users in Grafana does not exceed the number of users in your combined license. If it does, then new users cannot sign in to Grafana 8.3 until the active user count returns below the licensed limit.

Determining your current license type

You can identify your license type in Grafana 8.3 and higher. If you are running Grafana 8.2 or older, refer to your contract to determine your license type.

To determine if you have tiered pricing or combined pricing, complete the following steps in Grafana v8.3 or higher:

Sign in to Grafana as a system administrator.
Hover your mouse over Server Admin (the shield icon), and click Statistics and licensing.
In the Utilization panel, review the license count data.
- If you see Admins & Editors and Viewers, then you have a tiered license.
- If you only see Users, then you have a combined license.

License restrictions common to both license types

Your license is controlled by the following rules:

License expiration date: The license includes an expiration date, which is the date when a license becomes inactive.

As the license expiration date approaches, you will see a banner in Grafana that encourages you to renew. To learn about how to renew your license and what happens in Grafana when a license expires, refer to License expiration.

Grafana License URL: Your license does not work with an instance of Grafana with a different root URL.

The License URL is the root URL of your Grafana instance.

Concurrent sessions limit: As of Grafana Enterprise 7.5, users can initiate up to three concurrent sessions of Grafana.

The system creates a session when a user signs in to Grafana from a new device, a different browser, or an incognito window. If a user signs in to Grafana from another tab or window within the same browser, only one session is used.

When a user reaches the session limit, the fourth connection succeeds and the longest inactive session is signed out.

Request usage billing

You can request Grafana Labs to activate usage billing which allows an unlimited number of active users. When usage billing is enabled, Grafana does not enforce active user limits or display warning banners. Instead, you are charged for active users that exceed the limit, according to your customer contract.

Usage billing involves a contractual agreement between you and Grafana Labs, and it is only available if Grafana Enterprise is configured to automatically refresh its license token.

Request a change to your license

To increase the number of licensed users within Grafana, extend a license, or change your licensed URL, contact Grafana support or your Grafana Labs account team. They will update your license, which you can activate from within Grafana.

For instructions about how to activate your license after it is updated, refer to Activate an Enterprise license.

Activate a Grafana Enterprise license purchased through AWS Marketplace

Sat, 04 Apr 2026 12:26:57 +0000

Activate a Grafana Enterprise license purchased through AWS Marketplace

AWS Marketplace is a convenient place for AWS customers to buy and manage a license for Grafana Enterprise versions 8.3.0 and later.

Grafana Enterprise license on Grafana Labs

Activate an Enterprise license

Activate an Enterprise license

Step 1. Download your license file

Step 2. Add your license to a Grafana instance

Upload the license file via the Grafana server administrator page

Put the license.jwt file into the data directory of Grafana

Set the content of the license file as a configuration option

Step 3. Ensure that the license file’s root URL matches the root_url configuration option

Step 4. Restart Grafana

License expiration

License expiration

Update your license

If your license expires

Data source permissions

LDAP authentication

SAML authentication

Reporting

Enterprise plugins

White labeling

Usage insights

Vault integration

Auditing

License restrictions

Settings updates at runtime

License restrictions

Understanding Grafana Enterprise licensing

Tiered licensing

Active users limit

Permission domains

Grant dashboard edit without save permissions

Determine the number of active users for each licensed role

Optimize your tiered license

Update user permissions for dashboards

Combined licensing

Transition to combined license model

Determining your current license type

License restrictions common to both license types

Request usage billing

Request a change to your license

Activate a Grafana Enterprise license purchased through AWS Marketplace

Activate a Grafana Enterprise license purchased through AWS Marketplace

Put the `license.jwt` file into the data directory of Grafana