Docker Enterprise licensing¶

This page provides information about Docker Enterprise 3.0 licensing. Docker Enterprise 3.0 is a soft bundle of products that deliver the complete desktop-to-cloud workflow.

Complete the following steps to license Docker Enterprise 3.0:

Set up your Docker Hub ID, Organizations, and Team. Register your Docker license key. Activate your subscription. Access and download your license. Apply the license. Set up Docker Hub IDs, Organization, and Teams Before you begin, identify who needs access to the Docker license files. This may be any number of users across your company, agency, or organization. Create a Docker Hub ID for each person that requires access to the license file. Visit Docker Hub to create a Docker ID. This requires email verification. Ensure that you provide a corporate email address. Decide on the name of the Hub Organization that will be used to access licenses. The designated team leader must log into Docker Hub and create the Hub Organization. For more information about creating organizations, see Teams and Organizations.

The name of the Hub Organization must be unique across Docker Hub. If you have multiple independent organizations within your company, for example, if you represent ‘OrgB’ within ‘CompanyA’, use an Organization name such as ‘CompanyAOrgB’ instead of ‘CompanyA’. Ensure that the company’s licenses are registered to the organization, rather than an individual. Otherwise, the team will not be able to access the license(s).

On the Organizations page, select your organization, and then click on the Teams tab. You should see the name of your organization, and the Choose Team option below that. You should also see that you have a special team called owners. The owners team has full access to all repositories within the organization. Click Add User and add the Docker ID of every member that needs access to the license files. After entering each Docker ID, ensure the IDs are displayed in the Members section within the owners team. Register your Docker license key When your license order has been processed by Docker, your support administrator, designated support contact, billing contact, or the primary sales point of contact receives a welcome email. This email contains a link to an onboarding experience and your license keys.

It is important to note that only one recipient, preferably the support administrator or technical primary point of contact, must click on the links and follow the instructions in the welcome email.

Depending on which type of email your team receives, there may be several intermediate steps before you are directed towards activating your subscription.

Activate your subscription Log into the Docker Hub using your Docker ID and enter the activation key provided in your welcome email. Click the Submit Access Key button. From the Subscribe as drop-down menu, select the ID you would like the subscription applied to. Click the check box to agree to the terms of service and then click Confirm and Subscribe. Your subscription is now available. You will then be redirected to the My Content page. On the My Content page, click the Setup button on your Docker Enterprise subscription to access your license keys.

Access and download your license When you click the Setup button in step 6 above, you will be redirected to the setup instructions page where you can click the License Key link and download your Enterprise license. This page contains links and instructions on obtaining software such as MKE, MSR, Desktop Enterprise, and Mirantis Container Runtime.

Apply the license After you’ve downloaded the license keys, you can apply it to your Docker Enterprise component. The following section contains information on how to apply the license to MKE, MSR, Mirantis Container Runtime, and Docker Desktop Enterprise components.

MKE Log into the MKE web UI using the administrator credentials. Navigate to the Admin Settings page. On the left pane, click License and then Upload License. The license is refreshed immediately. For details, see Licensing MKE.

MSR Navigate to https:// and log in with your credentials. Select System from the left navigation pane. Click Apply new license and upload your license key. For details, see Licensing MSR.

MCR When you license MKE, the same license is applied to the underlying engines in the cluster. Docker recommends that Enterprise customers use MKE to manage their license.

Desktop Enterprise Docker Desktop Enterprise licenses are not included as part of your MKE, MSR, and MCR license. It is a separate license installed on developer workstations. Please contact your Sales team to obtain Docker Desktop Enterprise licenses.

Install the Docker Desktop Enterprise license file at the following location:

On macOS:

/Library/Group Containers/group.com.docker/docker_subscription.lic

On Windows:

%ProgramData%DockerDesktopdocker_subscription.lic

You must create the path if it doesn’t already exist. If the license file is missing, you will be asked to provide it when you try to run Docker Desktop Enterprise. Contact your system administrator to obtain the license file.

What happens when my Enterprise license expires? If there is a lapse in your Docker Enterprise entitlements, you will be alerted in the product until a new license is applied. However, you will not lose access to the software.

MCR: Mirantis Container Runtime doesn’t depend on the license being installed for ongoing functionality. It only requires licensing to access the package repositories. Note that an expired license may affect the node’s ability to upgrade.

MKE: MKE components continue to work as expected when the license expires. However, warning banners regarding the license expiry will appear in the MKE web UI.

MSR: Image pushes to MSR will be disabled once the license expires. All other functionality will persist.

Desktop: Warnings regarding the license expiry appear in the Desktop UI. Note that an expired license may affect the software’s ability to upgrade.

Please work with your sales team to ensure that your licenses are renewed before the expiration date on your licenses.