15.8. Database connect string

Due to its use of a database abstraction layer, eduMFA can work with several databases with the help of corresponding database drivers.

The database and corresponding diver are specified in the connect string SQLALCHEMY_DATABASE_URI in The Config File

15.8.1. MySQL / MariaDB

While there are several database driver packages for MySQL, we recommend PyMySQL which is a pure Python package and does not require external libraries or a build environment on the server.

PyMySQL is already installed in the virtual environment as a requirement for eduMFA.

connect string: mysql+pymysql://<user>:<password>@<host>/<database>

15.8.2. PostgreSQL

PostgreSQL is tested using the psycopg2 driver which can be installed into the eduMFA virtual environment with:

(eduMFA) $ pip install psycopg2_binary

The corresponding connect string looks like this:

connect string: postgresql+psycopg2://<user>:<password>@<host>/<database>

15.8.3. Other databases

While we recommend MySQL as the backend database we regularly test MariaDB and PostgreSQL as well.

Other databases like Oracle or MSSQL are working as well but not all functionality can be assured, so be aware that “Your mileage may vary”.