mc license register

The mc license register command connects your deployment with your MinIO SUBNET account.

The registration process collects the following information about the cluster for upload to SUBNET:

  • Deployment ID
  • Cluster Name
  • Used capacity
  • AIStor Object Store version
  • Number of server pools
  • Number of servers
  • Number of drives
  • Total space across all drives
  • Space used across all drives
  • Number of buckets
  • Number of objects

After registration, you can upload deployment health reports directly to SUBNET using the mc support diag command.

For more information about license management, expiration states, and renewal procedures, see Licenses.

Syntax

Parameters

ALIAS

Required

The alias of the AIStor deployment.

--airgap

Optional

Use in environments without network access to SUBNET (for example, airgapped, firewalled, or similar configuration).

For instructions, see the airgap example.

If the deployment is airgapped, but the local device where you are using the AIStor Client has network access, you do not need to use the --airgap flag.

--license

Optional

Version added
The --license parameter was added in AIStor Client RELEASE.2025-12-19T20-11-44Z.

Path to the license file to use for registering the deployment.

When specified, the command registers the deployment and applies the license in a single operation. This is particularly useful for airgapped environments or when you want to ensure the license is applied immediately during registration.

You must first download the license file for the account.

For instructions on downloading your license file, see Accessing your license.

When omitted, the command registers the deployment using the already-installed deployment license. Without a valid license, the command fails.

Examples

Register a deployment using the account’s license file

Register a new AIStor deployment at alias myaistor2 on SUBNET and apply the license in a single operation:

mc license register myaistor2 --license /path/to/minio.license

Replace /path/to/minio.license with the path to your downloaded license file.

For instructions on downloading your license file, see Accessing your license.

Register a deployment without direct internet access

Register an AIStor deployment at alias myaistor7 on SUBNET that does not have direct Internet access due to a firewall, airgap, or the like.

  1. Download the license file from SUBNET.

  2. Register the cluster with mc license register.

    mc license register myaistor7 --airgap --license /path/to/minio.license
    

    AIStor returns a URL.

  3. Copy the URL and access the URL from a browser on a device with internet access.

Verify registration

After registering your deployment, verify the license successfully installed to the cluster:

mc license info ALIAS

Replace ALIAS with the alias for your deployment.

Check that the deployment appears on the Deployments page in SUBNET to verify registration.

For more information, see mc license info.

Global flags

This command supports any of the global flags.