Activate a Grafana Enterprise license purchased through AWS Marketplace on Grafana Labs

Activate a Grafana Enterprise license from AWS Marketplace on EKS

Fri, 03 Apr 2026 19:43:06 +0000

Activate a Grafana Enterprise license from AWS Marketplace on EKS

If you have purchased a Grafana Enterprise subscription through AWS Marketplace, you must activate it to use Grafana Enterprise data source plugins and features in Grafana.

Before you begin:

Purchase a subscription to Grafana Enterprise from AWS Marketplace.
Be sure that the IAM user that was used to purchase Grafana Enterprise has permission to manage subscriptions, create new IAM users and roles, and create access policies.

To activate your license, complete the following tasks:

Task 1: Deploy Grafana Enterprise on Amazon EKS

Deploy Grafana Enterprise on Amazon EKS.

For more information about deploying an application on Amazon EKS, refer to Getting started with Amazon EKS – AWS Management Console and AWS CLI.

For more information about installing Grafana on Kubernetes using the Helm Chart, refer to the Grafana Helm Chart.
Use kubectl set image deployment/my-release grafana=grafana/grafana-enterprise:<version> to update the container image.

For example, enter grafana/grafana-enterprise:11.3.0.

Only Grafana Enterprise versions 8.3.0 and later support licenses granted through AWS Marketplace.

Task 2: Configure Grafana for high availability

Grafana requires that you configure a database to hold dashboards, users, and other persistent data.

Before you begin

Ensure that you have a supported Grafana database available.
- For a list of supported databases, refer to Supported databases.
- For information about creating a database, refer to Creating an Amazon RDS DB instance.
Review the information required to connect to the RDS DB instance. For more information, refer to Connecting to an Amazon RDS DB instance.

To configure Grafana for high availability, choose one of the following options:

Option 1: Use kubectl edit configmap grafana to edit grafana.ini add the following section to the configuration:

[database]
type = [database type]
host = [database address and port]
name = [database name]
user = [database username]
password = [database password]

Option 2: use kubectl edit deployment my-release to edit the pod env variables and add the following database variables:

- name: GF_DATABASE_TYPE
  value: [database type]
- name: GF_DATABASE_HOST
  value: [database address and port]
- name: GF_DATABASE_NAME
  value: [database name]
- name: GF_DATABASE_USER
  value: [database username]
- name: GF_DATABASE_PASSWORD
  value: [database password]

For more information on Grafana High Availability setup, refer to Set up Grafana for high availability.

Task 3: Configure Grafana Enterprise to validate its license with AWS

In this task, you configure Grafana Enterprise to validate the license with AWS instead of Grafana Labs.

In AWS IAM, assign the following permissions to the Node IAM role (if you are using a Node Group), or the Pod Execution role (if you are using a Fargate profile):
- "license-manager:CheckoutLicense"
- "license-manager:ListReceivedLicenses"
- "license-manager:GetLicenseUsage"
- "license-manager:CheckInLicense"
For more information about creating an access policy, refer to Creating IAM policies (console).

For more information about AWS license permissions, refer to Actions, resources, and condition keys for AWS License Manager.
Choose one of the following options to update the license_validation_type configuration to aws:
- Option 1: Use kubectl edit configmap grafana to edit grafana.ini add the following section to the configuration:
```
[enterprise]
license_validation_type=aws
```
- Option 2: Use kubectl edit deployment my-release to edit the pod env variables and add the following variable:
```
name: GF_ENTERPRISE_LICENSE_VALIDATION_TYPE
value: aws
```

Task 4: Start or restart Grafana

To activate Grafana Enterprise features, you must start (or restart) Grafana.

To restart Grafana on a Kubernetes cluster,

Run the command kubectl rollout restart deployment my-release.
After you update the service, navigate to your Grafana instance, sign in with Grafana Admin credentials, and navigate to Administration > General > Stats and license to validate that your license is active.

For more information about restarting Grafana, refer to Restart Grafana.

If you experience issues when you update the EKS cluster, refer to Amazon EKS troubleshooting.

Activate a Grafana Enterprise license from AWS Marketplace on ECS

Fri, 03 Apr 2026 19:43:06 +0000

Activate a Grafana Enterprise license from AWS Marketplace on ECS

If you have purchased a Grafana Enterprise subscription through AWS Marketplace, you must activate it in order to use Grafana Enterprise data source plugins and features in Grafana.

Before you begin

Purchase a subscription to Grafana Enterprise from AWS Marketplace.
Be sure that the IAM user that was used to purchase Grafana Enterprise has permission to manage subscriptions, create new IAM users and roles, and create access policies.

To activate your license, complete the following tasks.

Task 1: Deploy Grafana Enterprise on Amazon ECS

Deploy Grafana Enterprise on Amazon ECS.

For more information about deploying an application on Amazon ECS, refer to Creating an Amazon ECS service.
As you create the Amazon ECS service, use the intended Grafana Enterprise container image version.

For example, enter grafana/grafana-enterprise:11.3.0.

Only Grafana Enterprise versions 8.3.0 and later support licenses granted through AWS Marketplace.

Task 2: Configure Grafana for high availability

Grafana requires that you configure a database to hold dashboards, users, and other persistent data.

Before you begin

Ensure that you have a supported Grafana database available.
- For a list of supported databases, refer to Supported databases.
- For information about creating a database, refer to Creating an Amazon RDS DB instance.
Review the information required to connect to the RDS DB instance. For more information, refer to Connecting to an Amazon RDS DB instance.

To configure Grafana for high availability:

In AWS ECS, use environment variables to update the database parameters.

For a list of database parameters, refer to Configuration.
Create a revision of the task definition for the ECS Task that runs Grafana Enterprise.

For more information about creating a task, refer to Updating a task definition using the classic console.

Within the new revision, edit the Grafana Enterprise container for this task, and add the following environment variables to the container:

GF_DATABASE_TYPE=[database type]
GF_DATABASE_HOST=[database address and port]
GF_DATABASE_NAME=[database name]
GF_DATABASE_USER=[database username]
GF_DATABASE_PASSWORD=[database password]

For more information about how to update your ECS service with an environment variable, refer to Updating a service using the new console.

Task 3: Configure Grafana Enterprise to validate its license with AWS

In this task you configure Grafana Enterprise to validate the license with AWS instead of Grafana Labs.

In AWS IAM, create an access policy with the following permissions:
- "license-manager:CheckoutLicense"
- "license-manager:ListReceivedLicenses"
- "license-manager:GetLicenseUsage"
- "license-manager:CheckInLicense"
For more information about creating an access policy, refer to Creating IAM policies (console).

For more information about AWS license permissions, refer to Actions, resources, and condition keys for AWS License Manager.
Create an Elastic Container Service task role and attach the policy you created in the previous step.

For more information about creating a task role, refer to IAM Roles for Tasks.
Create a revision of the task definition for the ECS Task that runs Grafana Enterprise.

For more information about creating a revision of the task definition, refer to Updating a task definition using the classic console.
Within the new revision, perform the following steps:

a. Update the Task Role of your ECS Task to the role that you created, with permission to access license information.

b. Edit the Grafana Enterprise container for this task, and add the following environment variable to the container:
```
GF_ENTERPRISE_LICENSE_VALIDATION_TYPE=aws
```
For more information about how to update your ECS service with an environment variable, refer to Updating a service using the new console.

Task 4: Start or restart Grafana

To restart Grafana and activate your license, update the service running Grafana to use the latest revision of the task definition that you created.
After you update the service, navigate to your Grafana instance, sign in with Grafana Admin credentials, and navigate to Administration > General > Stats and license to validate that your license is active.

For more information about validating that your license is active, refer to Grafana Enterprise license restrictions.

Activate a Grafana Enterprise license from AWS on an instance deployed outside of AWS

Fri, 03 Apr 2026 19:43:06 +0000

Activate a Grafana Enterprise license from AWS on an instance deployed outside of AWS

While AWS Marketplace lists ECS and EKS as the supported environments for Grafana Enterprise, you can apply a Grafana Enterprise license from AWS Marketplace to any Grafana instance with network access to the AWS licensing service.

Before you begin

Purchase a subscription to Grafana Enterprise from AWS Marketplace.
Be sure that the IAM user that was used to purchase Grafana Enterprise has permission to manage subscriptions, create new IAM users, and create access policies.
Be sure there is network access between AWS and the environment where you intend to run Grafana. Network access is required because your Grafana instance communicates with the AWS License Manager endpoints and quotas to retrieve license and subscription information. Grafana instances with access to the public internet will have access to AWS license manager.

To activate a Grafana Enterprise license from AWS on a Grafana Enterprise instance deployed outside of AWS, complete the following tasks.

Task 1: Install Grafana Enterprise

To install Grafana, refer to the documentation specific to your implementation.

Task 2: Create an AWS IAM user with access to your Grafana Enterprise license

To retrieve your license, Grafana Enterprise requires access to your AWS account and license information. To grant access, create an IAM user in AWS with access to the license, and pass its credentials as environment variables on the host or container where Grafana is running. These environment variables allow Grafana to retrieve license details from AWS.

In the AWS License Manager service, create an IAM policy with the following permissions:
- "license-manager:CheckoutLicense"
- "license-manager:ListReceivedLicenses"
- "license-manager:GetLicenseUsage"
- "license-manager:CheckInLicense"
For more information about creating a policy in AWS, refer to Creating IAM policies.

For more information about AWS Identity and Access Management, refer to IAM users.

To limit the policy to obtain usage data just for Grafana Enterprise, in the Resources section of the policy, specify your license ARN.

You can find your license ID in the Granted Licenses section of AWS License Manager.

The policy JSON should look similar to the following example:

{
   "Version": "2012-10-17",
   "Statement": [
      {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "license-manager:GetLicenseUsage",
            "Resource": "arn:aws:license-manager::[YOUR_ACCOUNT]:license:[YOUR_LICENSE_ID]"
      },
      {
            "Sid": "VisualEditor1",
            "Effect": "Allow",
            "Action": [
               "license-manager:CheckoutLicense",
               "license-manager:ListReceivedLicenses",
               "license-manager:CheckInLicense"
            ],
            "Resource": "*"
      }
   ]
}

Create an IAM user and choose access key credentials as its authentication method.

For more information about creating an IAM user, refer to IAM users.

For more information about access key credentials, refer to Managing access keys for IAM users.
Attach the policy you created to the IAM user.
Add the following values as environment variables to the host or container running Grafana:
- AWS region
- IAM user’s access key ID
- IAM user’s secret access key
The environment variables should look similar to the following example:
```
AWS_ACCESS_KEY_ID=ABCD5E75FGHIJKTM7
AWS_SECRET_ACCESS_KEY=k8fhYAQVy+5NhCejhe6HeSjSphjRuy+12C06
AWS_REGION=us-east-1
```

Task 3: Configure Grafana Enterprise to validate its license with AWS

In this task you configure Grafana Enterprise to validate the license with AWS instead of Grafana Labs.

Choose one of the following options to update the license_validation_type configuration to aws:

Option 1: In the [enterprise] section of the grafana.ini configuration file, add license_validation_type=aws.

For example:
```
[enterprise]
license_validation_type=aws
```
Option 2: Add the following environment variable to the container or host:
```
GF_ENTERPRISE_LICENSE_VALIDATION_TYPE=aws
```

Task 4: Start or restart Grafana

To activate Grafana Enterprise features, start (or restart) Grafana.

For information about restarting Grafana, refer to Restart Grafana.

Manage your Grafana Enterprise license in AWS Marketplace

Fri, 03 Apr 2026 19:43:06 +0000

Manage your Grafana Enterprise license in AWS Marketplace

You can use AWS Marketplace to make the following modifications to your Grafana Enterprise license:

Add active users
Remove active users
Cancel your subscription to Grafana Enterprise.

To modify your Grafana Enterprise subscription in AWS Marketplace:

Open the AWS Console and navigate to Subscription Management.
Update your license.
Sign in to Grafana as a Server Administrator.
Click Administration in the side navigation menu, General, and then Stats and license.
In the Token section under Enterprise License, click Renew token.

This action retrieves updated license information from AWS.

To learn more about licensing and active users, refer to Activate a Grafana Enterprise license purchased through AWS Marketplace.

Transfer your AWS Marketplace Grafana Enterprise license

Fri, 03 Apr 2026 19:43:06 +0000

Transfer your AWS Marketplace Grafana Enterprise license

You can transfer your AWS Marketplace Grafana Enterprise license to another Grafana Enterprise instance. The transfer process requires that you first remove your license from one instance, and then apply the license to another instance.

When you remove an Enterprise license, the system immediately disables all Grafana Enterprise features.

To remove an Enterprise license from a Grafana Enterprise instance, perform one of the following steps:

If you are using Amazon ECS or Amazon EKS, remove the GF_ENTERPRISE_LICENSE_VALIDATION_TYPE environment variable from the container.
If you have deployed Grafana Enterprise outside of AWS, remove the aws license_validation_type value from the grafana.ini configuration file.

It can take the system up to one hour to clear the license. After the system clears the license, you can apply the same license to another Grafana Enterprise instance.

To determine that the system has returned your license, check the license details in AWS License Manager.