Change Hostname or IP Address

Steps for safely modifying the hostname or IP address of the Enterprise Manager server and ensuring all monitored agents remain connected.

To set the hostname or IP address for an existing MariaDB Enterprise Management instance, follow these instructions. Changing the hostname or IP address is useful if your server's IP changed or if you need to switch from an IP address to a public DNS name.

1

Connect to your server

SSH into the server where your Enterprise Manager is running:

ssh user@your-server-ip

2

Navigate to the directory

Change into the enterprise-manager directory, where your Docker Compose files are located:

cd enterprise-manager

3

Edit the .env file

Open the environment file with a text editor (for example nano):

nano .env

Find the line that begins with MEMA_HOSTNAME= and update it with the new hostname or IP address. Example:

MEMA_HOSTNAME=your.new.hostname.or.ip

4

Save the file

Save the file and exit the editor.

5

Restart the services

Restart the MEM services so the new environment variable takes effect. The --force-recreate flag ensures the containers are rebuilt using the updated environment variables:

docker compose up -d --force-recreate

After the restart, your Enterprise Manager will be accessible at the new hostname or IP address.

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