title	summary
tiup uninstall	The tiup uninstall command is used to uninstall installed components. It has options to uninstall all versions of a component and to uninstall TiUP itself. If the command exits without error, it outputs "Uninstalled component successfully!" If no version or --all is specified, it reports an error to use "tiup uninstall tidbx --all" to remove all versions.

tiup uninstall

The tiup uninstall command is used to uninstall the installed components.

Syntax

tiup uninstall <component1>:<version> [component2...N] [flags]

<component1>: the name of the component to uninstall.
<version>: the version to uninstall. If this field is omitted, all installed versions of the component are uninstalled. For security reasons, the --all option must be added when <version> is omitted, indicating that all versions of a component need to be uninstalled.
[component2...N]: multiple components or versions to uninstall.

Uninstalls all installed versions of the specified component(s). You must use this option when <version> is omitted.
Data type: BOOLEAN
This option is disabled by default and its default value is false. To enable this option, you can add this option to the command, and pass the true value or do not pass any value.

Uninstalls TiUP itself. When this option is used, all data downloaded from the mirror is deleted, but the data generated by TiUP and its components is retained. The data is stored in the directory specified by the TIUP_HOME environment variable. If TIUP_HOME is not set, the default value is ~/.tiup/.
Data type: BOOLEAN
This option is disabled by default and its default value is false. To enable this option, you can add this option to the command, and pass the true value or do not pass any value.

If the command exits without any error, Uninstalled component "%s" successfully! is output.
If neither <version> nor --all is specified, the Use "tiup uninstall tidbx --all" if you want to remove all versions. error is reported.