mc license update

The mc license update command updates or renews the license for an AIStor deployment.

The command supports two modes of operation:

• Automatic update from SUBNET - Retrieves the latest license from MinIO SUBNET and applies it to the deployment. The deployment must already have a licensed installed for this mode to work.
• Manual update with license file - Applies a license from a specified file path.

Use this command to update expired or expiring licenses without restarting the AIStor deployment. You can also use this command to add a license to a new cluster started without a license or in an airgapped environment.

AIStor applies the updated license immediately.

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

mc license update myaistor

mc [GLOBALFLAGS] license update              \
                         ALIAS               \
                         [LICENSE_FILE_PATH]

Required

The alias of the AIStor deployment.

Optional

The path to a license file to use for updating the deployment.

When specified, the command reads the license from the file and applies it to the deployment.

When omitted, the command retrieves the latest license from SUBNET and applies it to the deployment.

After running mc license update, AIStor detects and applies the license change automatically.

By default, AIStor checks for license updates every 24 hours.

The command validates the license before applying it. AIStor rejects licenses that:

• Are older than the currently installed license
• Have an earlier expiration date than the current license
• Are invalid or corrupted

If the license validation fails, the current license remains in use.

Update the license for the AIStor deployment at alias myaistor by retrieving the latest license from SUBNET:

mc license update myaistor

This mode requires the deployment to have network access to SUBNET.

Update the license for the AIStor deployment at alias myaistor using a downloaded license file:

mc license update myaistor /path/to/minio.license

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

This mode works in airgapped or restricted network environments.

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

Update an expired license for the AIStor deployment at alias myaistor:

mc license update myaistor

If the deployment is in safe mode due to an expired license, updating the license restores full functionality.

After updating an expired license, verify the new license status:

mc license info myaistor

In an airgapped environment, download the license file on a machine with SUBNET access, then transfer it to the airgapped environment:

1. Download the license file from SUBNET on a machine with internet access. For instructions, see Accessing your license.

2. Transfer the license file to the airgapped environment using your approved file transfer method

3. Update the license using the transferred file:

   mc license update myaistor /path/to/minio.license
   

This command supports any of the global flags.