Licenses

MinIO AIStor requires an active and unexpired MinIO Commercial License.

Use mc license info to check your current license status.

Accessing your license

The license is available in MinIO SUBNET.

Log in to SUBNET.
From the Deployments screen, select License Key.
Select the copy button to the right of license key string.

or

Select Download to save the minio.license to your local device.
Save the license value or file according to your security guidelines. For example, store the license value in a secure vault.

If this is a new deployment, register it with SUBNET using mc license register to enable automatic license updates and support features.

License renewal

Version added

Automatic license renewal and the mc license update command were added in AIStor Server RELEASE.2025-12-20T04-58-37Z.

For earlier versions, use the manual license file replacement method.

MinIO AIStor automatically attempts to renew expired licenses from SUBNET every 24 hours. If your license is renewed in SUBNET, MinIO AIStor detects and applies the updated license without manual intervention.

You can also manually update the license using one of the following methods.

Update license using mc license update

Use the mc license update command to update the license in your deployment.

Automatic update from SUBNET:

mc license update ALIAS

MinIO AIStor retrieves the latest license from SUBNET and applies it to the deployment.

Update using a license file:

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

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

Replace ALIAS with the alias for your deployment.

Update license by replacing the license file

You can also update the license by replacing the license file on all MinIO AIStor nodes.

Use the Accessing your license instructions to download the new license from SUBNET.
Replace the license file on all MinIO AIStor nodes.
Kubernetes (Helm)
Upgrade the Helm installation with the new license:
```
helm upgrade -n aistor aistor minio/aistor-operator \
  --set license="eyJhbGciOiJFUzM4NCIsInR..."
```
Replace the license value with your decoded JWT token from SUBNET.

If you use a custom values file, include it in the upgrade:
```
helm upgrade -n aistor aistor minio/aistor-operator \
  --set license="eyJhbGciOiJFUzM4NCIsInR..." \
  -f aistor-operator-values.yaml
```
Linux

Replace minio.license in opt/minio/ with the new minio.license file downloaded from SUBNET.

This must be done on each node in the MinIO AIStor deployment.
Wait for automatic license refresh or restart MinIO AIStor.

MinIO AIStor automatically detects and applies license file changes every 24 hours.

To apply the license immediately, restart MinIO AIStor by running:
```
mc admin service restart ALIAS
```
- Replace ALIAS with the alias for your deployment.
Downtime

Restarting MinIO AIStor may result in minimal downtime for your MinIO AIStor server.
Verify the license was applied successfully.
```
mc license info ALIAS
```
Replace ALIAS with the alias for your deployment.

License expiration

It is important to keep an active license to maintain access to MinIO AIStor and the data stored in your deployment.

When a license expires, MinIO AIStor transitions through several states. The server never terminates due to license expiration. The following tables summarize the effects of license expiration.

MinIO Commercial License

Status	State	Notifications	Effect
Unexpired	Normal	None	Full access to all of MinIO AIStor
Expiration within 30 days	Normal	Banner in SUBNET, emails to users	Full access to all of MinIO AIStor
Expired less than 90 days	Read-only	Banner in SUBNET, emails to users, server logs	Read operations allowed. Write operations blocked. Admin API and Console remain accessible. MinIO AIStor attempts automatic license renewal from SUBNET every 24 hours.
Expired more than 90 days	Offline	Banner in SUBNET, server logs	All S3 operations blocked. Admin API, Console, health checks, and metrics remain accessible for license recovery.

License state details

Normal mode

When you have a valid license, MinIO AIStor operates with full functionality. All S3 operations and administrative functions are available.

A warning message appears in the server logs when the license will expire within 30 days. The message includes the expiration date and a recommendation to renew immediately.

Read-only mode (0-90 days after expiry)

After the license expires, MinIO AIStor enters read-only mode. The server continues running but blocks write operations to prevent data modification.

Read operations remain available to allow data retrieval and migration.

Server log message

License expired on expiry-date. MinIO is currently operating in read-only mode, wherein object creation is disallowed. Server will enter offline mode on offline-date. Renew immediately to avoid outage.

Operations blocked in read-only mode:

Creating buckets
Uploading objects
Deleting objects and buckets
Starting multipart uploads
Modifying bucket policies, lifecycle rules, and replication configuration

Operations allowed in read-only mode:

Reading objects
Listing buckets and objects
Downloading objects
All Admin API operations
Console UI (read-only)

Blocked operations return an error:

HTTP Status: 403 Forbidden
Error Code: AccessDenied
Message: “Write operations are not allowed. Server is running in read-only mode due to missing or expired license.”

Offline mode (90+ days after expiry)

After the read-only period ends, MinIO AIStor enters offline mode. In offline mode, all S3 API operations are blocked, including reads and writes.

The server continues running to allow license recovery. The following remain accessible:

Admin API endpoints (/minio/admin/*) for license management
Console UI (/minio/console/*) for administrative access
Health check endpoints (/minio/health/*)
Metrics endpoints (/minio/v3/metrics/*)

While the Console UI is accessible in offline mode, any object operations (upload, download, browse) performed through the console fail because they use the S3 API internally.

Server log message

No valid license found, running in offline mode. All S3 operations are denied. Please install a valid license to restore service.

Blocked operations return an error:

HTTP Status: 403 Forbidden
Error Code: AccessDenied
Message: “Access denied. License has fully expired. Please install a valid license to restore service.”

No license installed

Version changed

Starting without a license was added in AIStor Server RELEASE.2025-12-20T04-58-37Z.

Earlier versions require a valid license to start.

If MinIO AIStor starts without a license, the server operates in offline mode. All S3 operations are blocked, but the Admin API and Console remain accessible for license installation.

To install a license:

Access your license from SUBNET
Use mc license register to register a new deployment with SUBNET, or use mc license update to retrieve the latest license from SUBNET or apply a license file
Verify the license status with mc license info

The cluster immediately returns to normal operation after a valid license is installed.

Recovering from offline or read-only mode

If your cluster is in offline or read-only mode, install a valid license to restore full functionality:

mc admin config set ALIAS subnet license=<LICENSE_TOKEN>

Replace ALIAS with the alias for your deployment. Replace <LICENSE_TOKEN> with your license token from SUBNET.

The server does not need to be restarted. The cluster immediately returns to normal operation after a valid license is installed.

Monitoring license status

MinIO AIStor exposes Prometheus metrics for license monitoring:

Metric	Description
`minio_cluster_config_license_status`	Current license state: `normal`, `readonly`, or `offline`
`minio_cluster_config_license_expires_in`	Seconds until license expires (`-1` for non-expiring licenses)
`minio_cluster_config_license_renewal_status`	Last renewal attempt result: `success`, `failed`, or `expired`

Use these metrics to set up alerts and get notified before your license expires.

MinIO trial license

Status	State	Notifications	Effect
Unexpired	Normal	None	Full access to MinIO AIStor
Expired less than 60 days	Read-only	Emails to users, server logs	Read operations allowed. Write operations blocked. Admin API and Console remain accessible. MinIO AIStor attempts automatic license renewal from SUBNET every 24 hours.
Expired more than 60 days	Offline	Emails to users, server logs	All S3 operations blocked. Admin API, Console, health checks, and metrics remain accessible for license recovery.

Trial licenses have no grace period. The server enters read-only mode immediately upon expiration.

Default license phase durations may vary. Contact the MinIO team on SUBNET with any questions.

OEM and embedded deployments

The MinIO OEM Agreement permits OEM customers to integrate MinIO AIStor (in object code form) into a Vendor Combined Product and distribute it as part of that offering. OEM customers may sublicense MinIO AIStor to their end users under terms that include the restrictions and protections specified in the OEM Agreement.

The documentation in this site applies to all MinIO AIStor deployments, including those embedded within a Vendor Combined Product. OEM customers should follow the same installation, configuration, and administration procedures documented here regardless of their deployment context.

MinIO’s indemnification obligations apply only to MinIO AIStor Enterprise Lite and Enterprise plan purchases, as described in the OEM Agreement. MinIO is not liable for issues arising from use that does not comply with the OEM Agreement or the procedures documented on this site.

OEM Agreement governs licensing terms

The OEM Agreement defines the permitted use, distribution, and sublicensing terms for OEM deployments. This documentation provides product deployment and administration guidance but does not modify or extend the terms of any license agreement.

Contact SUBNET or your MinIO account representative with questions about OEM licensing.

MinIO AIStor Free (community use)

MinIO AIStor minio.RELEASE.2025-12-20T04-58-37Z or later adds support for MinIO AIStor Free licenses. MinIO AIStor Free allows small organizations, developers, and researchers to deploy single-node MinIO AIStor resources into environments that do not require high availability or select enterprise features. The following features are available only with MinIO AIStor Enterprise Lite and Enterprise licenses:

Distributed (multi-node) deployments
Replication (site, bucket, or batch)
Object tiering and lifecycle transitions
Version-specific object deletion
Profiling and diagnostics (CPU/memory profiling, health info, data inspection)
Performance testing (network, drive, object, and site replication benchmarks)
Telemetry and console log access
Background heal status
Top lock visibility
Any mc support command

MinIO AIStor Free is governed by the MinIO AIStor Free Agreement. This license does not include any Service Level Agreement (SLA), Service Level Objective (SLO), or similar warranty or service agreement.