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
--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.
-
Download the license file from SUBNET.
-
Register the cluster with
mc license register.mc license register myaistor7 --airgap --license /path/to/minio.licenseAIStor returns a URL.
-
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.