mc alias remove


The mc alias remove removes an existing alias from the local mc configuration.

The following command removes the myminio alias for a MinIO deployment from the host machine:

mc alias remove myminio

The mc alias remove command has the following syntax:

mc [GLOBALFLAGS] alias remove ALIAS
  • Brackets [] indicate optional parameters.

  • Parameters sharing a line are mutually dependent.

  • Parameters seperated using the pipe | operator are mutually exclusive.

Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.



Required The alias to remove from the local mc configuration.

Global Flags


Enables verbose output to the console.

For example:

mc --debug COMMAND

The path to a JSON formatted configuration file that mc uses for storing data. See Configuration File for more information on how mc uses the configuration file.


Enables JSON lines formatted output to the console.

For example:


Disables the built-in color theme for console output. Useful for dumb terminals.


Suppresses console output.


Disables TLS/SSL certificate verification. Allows TLS connectivity to servers with invalid certificates. Exercise caution when using this option against untrusted S3 hosts.


Displays the current version of mc.


Displays a summary of command usage on the terminal.


Remove an Alias from the mc Configuration

Use mc alias remove to remove an existing alias from the mc configuration:

The following command removes the myminio alias.

mc alias remove myminio
mc alias remove ALIAS

Replace ALIAS with the the name of the alias to remove.


S3 Compatibility

The mc commandline tool is built for compatibility with the AWS S3 API and is tested MinIO and AWS S3 for expected functionality and behavior.

MinIO provides no guarantees for other S3-compatible services, as their S3 API implementation is unknown and therefore unsupported. While mc commands may work as documented, any such usage is at your own risk.