> For the complete documentation index, see [llms.txt](https://mariadb.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mariadb.com/docs/tools/community/mariadb-shell/installation.md).

# Installation

Install MariaDB Shell on Linux, macOS, or Windows with an installation script or from a release package.

MariaDB Shell is distributed as self-contained packages on the [GitHub releases page](https://github.com/mariadb-corporation/mariadb-shell/releases). Each package includes the Python runtime and the built-in plugins, so it has no other runtime dependencies. You don't need administrator privileges: by default, everything installs into your home directory.

The installation scripts detect your platform, download the matching package, verify its SHA-256 checksum, and create the `mariadb-shell` and `msh` commands. If you prefer to control each step, download and unpack a package manually.

For the list of supported operating systems and architectures, see [Supported Platforms](/docs/tools/community/mariadb-shell/about-mariadb-shell.md#supported-platforms).

{% columns %}
{% column %}
{% content-ref url="/pages/oojPU6hv3hNYGbdOWP0u" %}
[Linux and macOS](/docs/tools/community/mariadb-shell/installation/linux-and-macos.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Install, upgrade, and remove MariaDB Shell with the `install.sh` script.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/eZerHCVRum8aDchQfAsq" %}
[Windows](/docs/tools/community/mariadb-shell/installation/windows.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Install, upgrade, and remove MariaDB Shell with the `install.ps1` PowerShell script.
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}
{% content-ref url="/pages/pCrQQS8dSeHmJbJ9AoxZ" %}
[Manual Installation](/docs/tools/community/mariadb-shell/installation/manual-installation.md)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Download a release package, verify it against `SHA256SUMS`, and unpack it yourself.
{% endcolumn %}
{% endcolumns %}

<sub>*This page is licensed: GPLv2*</sub>