Welcome to the upcoming version of the MinIO Documentation! The content on this page is under active development and may change at any time. If you can't find what you're looking for, check our legacy documentation. Thank you for your patience.

mc admin heal

Table of Contents


The mc admin heal command scans for objects that are damaged or corrupted and heals those objects.

mc admin heal is resource intensive and typically not required even after disk failures or corruption events. Instead, MinIO automatically heals objects damaged by silent bitrot corruption, disk failure, or other issues on POST/GET. MinIO also performs periodic background object healing.

Use mc admin on MinIO Deployments Only

MinIO does not support using mc admin commands with other S3-compatible services, regardless of their claimed compatibility with MinIO deployments.


mc admin heal has the following syntax:

mc admin heal [FLAGS] TARGET

mc admin heal supports the following arguments:



The full path to the bucket or bucket prefix on which the command should perform object healing. Specify the alias of a configured MinIO deployment as the prefix for the path. For example:

mc admin heal play/mybucket/myprefix

If the TARGET bucket or bucket prefix has an active healing scan, the command returns the status of that scan.


The type of scan to perform. Specify one of the following supported scan modes:

  • normal (default)

  • deep

--recursive, --r

Recursively scans for objects in the specified bucket or bucket prefix.


Inspects the TARGET bucket or bucket prefix, but does not perform any object healing.

--force-start, --f

Force starts the healing process.

--force-stop, --s

Force stops the healing sequence.


Removes dangling objects in the healing process.