# Installing MariaDB Enterprise Manager

{% hint style="info" %}
Prerequisites

* Prepare a machine for Enterprise Manager installation that complies with [Hardware and System Requirements](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/deployment/hardware-and-system-requirements)
* Make sure that you have required network ports opened: [Network and Firewall Requirements](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/deployment/hardware-and-system-requirements)
* Obtain MariaDB Customer Download Token
  * Navigate to the [Customer Download Token at the MariaDB Customer Portal](https://customers.mariadb.com/downloads/token/)
  * Log in using your [MariaDB ID](https://id.mariadb.com/)
  * Copy the Customer Download Token to use as the password when logging in to the MariaDB Enterprise Docker Registry
* Set up MariaDB Enterprise Repository - `MariaDB Enterprise Tools` for each monitored MariaDB Server and MaxScale
  * <https://mariadb.com/docs/server/server-management/install-and-upgrade-mariadb/installing-mariadb/binary-packages/mariadb-package-repository-setup-and-usage>
    {% endhint %}

## Standard Installation

{% stepper %}
{% step %}
**Log in to Docker registry**

Login to the MariaDB Enterprise Docker Registry providing your [MariaDB ID](https://id.mariadb.com/) as a username and Customer Download Token as a password.

* Docker:

<pre class="language-bash"><code class="lang-bash"># Login
<strong>docker login docker.mariadb.com
</strong></code></pre>

* Podman:

```bash
# Login
podman login --compat-auth-file .docker/config.json docker.mariadb.com
```

{% endstep %}

{% step %}
**Download the installer**

Insert your Customer Download Token into the download URL and download the installer:

{% code title="# Download installer" %}

```bash
wget https://dlm.mariadb.com/<Customer_Download_Token>/enterprise-release-helpers/install-enterprise-manager.sh
```

{% endcode %}
{% endstep %}

{% step %}
**Make the installer executable**

{% code title="# Make executable" %}

```bash
chmod +x install-enterprise-manager.sh
```

{% endcode %}
{% endstep %}

{% step %}
**Run the installer**

Install Enterprise Manager by running the installer:

{% code title="# Run installer" %}

```bash
./install-enterprise-manager.sh
```

{% endcode %}

The installer prompts you to enter IP address and port number on which Enterprise Manager should listen to for incoming connections. Verify the auto-detected value and correct it if it's wrong.

{% hint style="info" %}
This address and port must be reachable from all monitored MariaDB Server and MaxScale hosts.
{% endhint %}

After you provide the details, the installer launches Enterprise Manager.
{% endstep %}

{% step %}
**Verify containers**

Run `docker compose ps` in the `enterprise-manager` directory to check that all of the constituent Docker containers are running. The containers are:

* `enterprise-manager-grafana`
* `enterprise-manager-nginx`
* `enterprise-manager-otelcol`
* `enterprise-manager-prometheus`
* `enterprise-manager-supermax`

{% code title="# Check containers" %}

```bash
cd enterprise-manager
docker compose ps
```

{% endcode %}
{% endstep %}

{% step %}
**Access the UI**

Access Enterprise Manager UI at:

https\://`<Enterprise_Manager_IP>`:8090

At the login screen, use the default username `admin` and the generated password displayed after the installation finishes.
{% endstep %}
{% endstepper %}

The installer generates a self-signed TLS certificate for Enterprise Manager. To change the certificate, follow instructions at [Security in Enterprise Manager](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/security-in-enterprise-manager).

To modify metrics retention time, see [Metrics retention configuration](https://mariadb.com/docs/tools/mariadb-enterprise-manager/administration/deployment/installing-mariadb-enterprise-manager/metrics-retention-configuration).

## Air-Gapped Installation

Installing Enterprise Manager to a machine without an Internet connection is possible by manually copying the container images and related settings from an Internet-connected machine to the final target machine.

Follow these steps:

{% stepper %}
{% step %}
**Install on an Internet-connected machine**

First, install Enterprise Manager on an Internet-connected machine as explained in the normal installation section. When the installer asks for the address and port that Enterprise Manager should listen at for incoming connections, enter the values for the final target machine.
{% endstep %}

{% step %}
**Save images and settings**

Once installation is complete, save all related container images and settings by running the following commands from the directory that contains the `enterprise-manager` folder:

{% code title="# Save images and archive" %}

```bash
cd enterprise-manager
docker compose images | awk 'p{print $2 ":" $3} {p=1}' | xargs docker image save -o images.tar
cd ..
tar -czvf enterprise-manager.tar.gz enterprise-manager
```

{% endcode %}

The resulting archive `enterprise-manager.tar.gz` contains all components of Enterprise Manager.
{% endstep %}

{% step %}
**Transfer archive to target machine**

Copy `enterprise-manager.tar.gz` to the target (air-gapped) machine into the directory under which you want to install Enterprise Manager.
{% endstep %}

{% step %}
**Extract and load images on target machine**

On the target machine, extract the archive and load the container images:

{% code title="# Extract and load images" %}

```bash
tar -xzvf enterprise-manager.tar.gz
cd enterprise-manager
docker image load -i images.tar
```

{% endcode %}
{% endstep %}

{% step %}
**Start Enterprise Manager**

Start Enterprise Manager with:

{% code title="# Start containers" %}

```bash
docker compose up -d
```

{% endcode %}
{% endstep %}
{% endstepper %}

<sub>*This page is: Copyright © 2025 MariaDB. All rights reserved.*</sub>

{% @marketo/form formId="4316" %}