Using External MySQL Database

Configure Monolith to use an externally hosted MySQL database instead of the MySQL container included with the standard on-premises deployment.

Monolith can use an external MySQL database instead of the MySQL Docker container included with the standard on-premises deployment.

This can be used when your organization prefers to host and manage the Monolith database separately from the application containers.

Configure the External Database

To configure an external MySQL database, update the database connection values in the .env file included with your Monolith deployment.

The following values define the connection:

MONOLITH_DB_NAME=
MONOLITH_DB_USER=
MONOLITH_DB_PORT=
MONOLITH_DB_HOST=
MONOLITH_DB_PASSWORD=

Configure each value using the connection information for the MySQL database that will store your Monolith data.

• MONOLITH_DB_NAME: Name of the Monolith database

• MONOLITH_DB_USER: MySQL user used by Monolith

• MONOLITH_DB_PORT: Port used by the MySQL server

• MONOLITH_DB_HOST: Hostname or IP address of the MySQL server

• MONOLITH_DB_PASSWORD: Password for the configured MySQL user

When using an external MySQL database, database hosting, backup, and recovery should be planned according to your organization's infrastructure requirements.

See Backups for additional guidance on protecting Monolith data.

Related Documentation

• On-Premises Deployments

• Monolith Containers (Docker)

• Deployment

• Monolith Data

• Backups