Installing MariaDB Enterprise Manager

Step-by-step instructions for deploying the Docker-based Enterprise Manager Server, including standard online setups and air-gapped installation procedures.

Prerequisites

• Prepare a machine for Enterprise Manager installation that complies with Hardware and System Requirements

• Make sure that you have required network ports opened: Network and Firewall Requirements

• Obtain MariaDB Customer Download Token

  • Navigate to the Customer Download Token at the MariaDB Customer Portal

  • Log in using your MariaDB ID

  • 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

Standard Installation

1

Log in to Docker registry

Login to the MariaDB Enterprise Docker Registry providing your MariaDB ID as a username and Customer Download Token as a password:

# Login

docker login docker.mariadb.com

2

Download the installation script

Insert your Customer Download Token into the download URL and download the installation script:

# Download installer

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

3

Make the installer executable

# Make executable

chmod +x install-enterprise-manager.sh

4

Run the installer

Install Enterprise Manager by running the script:

# Run installer

./install-enterprise-manager.sh

The script 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.

This address and port must be reachable from all monitored MariaDB Server and MaxScale hosts.

After you provide the details, the script launches Enterprise Manager.

5

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

# Check containers

cd enterprise-manager
docker compose ps

6

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 script finishes.

The installer generates a self-signed TLS certificate for Enterprise Manager. To change the certificate, follow instructions at Security in Enterprise Manager.

To modify metrics retention time, see Metrics retention configuration.

Enterprise Manager Server Air-Gapped Installation

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

Follow these steps:

1

Install on an Internet-connected machine

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

2

Save images and settings

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

# Save images and archive

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

The resulting archive enterprise-manager.tar.gz contains all components of Enterprise Manager.

3

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.

4

Extract and load images on target machine

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

# Extract and load images

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

5

Start Enterprise Manager

Start Enterprise Manager with:

# Start containers

docker compose up -d

_{This page is: Copyright © 2025 MariaDB. All rights reserved.}