Troubleshooting
Table of Contents
Overview
MinIO users have two options for support.
Community support from the public Slack channel.
Community support is best-effort only and has no SLA or SLO.
The MinIO Subscription Network, SUBNET, provides either 48 hour or 1 hour SLA depending on subscription level.
For current licensing levels and pricing, refer to the MinIO SUBNET page.
SUBNET
SUBNET delivers 24/7/365 Direct-to-engineer support through a MinIO-built portal that blends the chat features of common communication tools with the support features of standard support platforms.
Features of SUBNET include:
Security and architecture reviews (depending on SLA)
Access to Panic Button, which provides immediate response to critical issues (depending on SLA)
Secure communication channel to exchange logs and software binaries
Unlimited seats for your team
Unlimited issues
For more information, see details at the MinIO SUBNET page.
Registering Your MinIO Deployment with SUBNET
You can register for SUBNET from the MinIO Console.
Go to your MinIO cluster’s URL, then sign in
Select the Support option
Select Register
Select the tab with the method to use to register:
Credentials tab to use your MinIO SUBNET username and password
API Key tab to input an API key you already have or obtain one directly from SUBNET
Airgap tab for a token and instructions to register a deployment that does not have direct connection to the Internet and/or SUBNET
Use the steps below to register MinIO deployments that do not have direct Internet access. For example, deployments that exist with an airgap, behind a firewall, or in other environments with no direct Internet access. From the Console:
Go to your MinIO cluster’s URL, then sign in
Select the Support tab, then select Health
Select Register your Cluster
Select the Airgap tab
Copy the provided link, which includes a token value for the deployment
Paste the link into a web browser on a device with access to the Internet
After successful registration, copy the provided API key
In the MinIO Console, select the API Key tab
Paste the copied API key from SUBNET into the API Key field, then select Register
You can register for SUBNET from the command line.
Refer to mc license register
for instructions.
For clusters without direct Internet access, refer to the instructions in the airgap example of the mc license register
documentation.
Download License File
Download the license file from SUBNET on a machine with access to the Internet.
Log in to MinIO SUBNET
Go to the Deployments tab
Select the deployment from the list
Select the License number near the top of the page to display the Cluster License Key
Select Download
SUBNET Issues
Use SUBNET issues to engage support from MinIO engineering.
Log in to https://subnet.min.io
Select the Issues section
Use the search bar to locate an existing issue or add a new issue.

Select an existing issue from the list to expand the conversation or add a response.

Reviewing Health Data in SUBNET
SUBNET provides health data about the clusters registered to the organization from the Deployments section.
The view shows the total size of the org’s MinIO clusters with details for each cluster.

Each of the organization’s clusters display below the summary data. Select a deployment row to view additional health details.
Deployment Health
The deployment’s details include a summary of the deployment’s configuration and the number of checks run and failed.
You can select Upload to add diagnostic health data obtained from the mc support diag
command or the MinIO Console’s Support > Health page.
If you need support from MinIO Engineering, you can create a New Issue for the deployment.

SUBNET displays health checks for data points such as CPU, drives, memory, network, and security.
Failed checks display first. Checks with warnings display after failed checks. Checks that pass display last.
Select any failed or warned checks to display the JSON output for additional details. You can scroll vertically through the output for the selected check.

Uploading Data to SUBNET
If you registered the cluster with SUBNET, Performance and Inspection files can automatically upload to SUBNET.
For clusters with an airgap, firewall, or otherwise blocked from SUBNET directly, you can manually upload files to SUBNET after logging in.
Generate the file(s) to upload from the command line with
mc support diag
ormc support inspect
Sign in to SUBNET
Select Deployments
Select Diagnostics
Drag and drop the
.gzip
file(s) or browse to the file location to upload
Encrypting Data
Data from the Inspect tool in Console or the mc support inspect
command can be encrypted.
For more details about encrypting or decrypting such files, see Encrypting Files.
Logs
Use mc support callhome enable
to start automatically uploading deployment logs to SUBNET for analysis.
Use mc support callhome status
to check the status of log upload.
You can disable upload at any time using mc support callhome disable
.
Use mc admin logs
command to display logs from the command line.
The command supports type and quantity filters for further limiting logs output.
Upgrades and Version Support
MinIO regularly releases updates to introduce features, improve performance, address security concerns, or fix bugs. These releases can occur very frequently, and vary by product.
Always test software releases in a development environment before upgrading on a production deployment.
Active Support Periods
Version support varies by the license used for the deployment.
License |
Support length |
---|---|
AGPLv3 |
Most recent release |
MinIO Standard |
1 year long term support of any release |
MinIO Enterprise |
5 year long term support of any release, SUBNET support for upgrade guidance and recommendations |
Recommended Upgrade Schedule
MinIO recommends always installing the most recent release to obtain the latest features, security enhancements, and performance improvements. We recognize that such a frequent release schedule may make this impractical for some organizations. In such cases, we recommend using MinIO and our related product releases that are no older than six months.
Version Alignment
As the various MinIO products release separately on their own schedules, we recommend the following version alignment practices:
- MinIO
Update to the latest release or a release no older than six months.
- MinIO Client
Update to the mc release that occurs immediately after the MinIO release, within one or two weeks.
- MinIO Operator
Use a MinIO version no earlier than the latest at the time of the Operator release. The MinIO version latest at time of release can be found in the quay.io link in the example tenant kustomization yaml file for the Operator release.
4.5.5: MinIO RELEASE.2022-12-07T00-56-37Z or later
4.5.6: MinIO RELEASE.2023-01-02T09-40-09Z or later
4.5.7: MinIO RELEASE.2023-01-12T02-06-16Z or later
4.5.8: MinIO RELEASE.2023-01-12T02-06-16Z or later
When creating a new tenant, the Operator uses either the latest available MinIO release image or the image you specify when creating the tenant.
Upgrading the Operator does not automatically upgrade existing tenants. Upgrade existing tenant MinIO versions separately.