[GH-ISSUE #555] Docker, Error loading MySQLdb module: Did you install mysqlclient? #430

New issue

Closed

opened 2026-02-25 21:31:54 +03:00 by kerem · 2 comments

kerem commented

2026-02-25 21:31:54 +03:00

Owner

Originally created by @philiplb on GitHub (Sep 22, 2023).
Original GitHub issue: https://github.com/ciur/papermerge/issues/555

Originally assigned to: @ciur on GitHub.

Description
When starting a container with the image papermerge/papermerge:2.1.9 with PAPERMERGE__DATABASE__TYPE=mysql, I get the following error (due to a missing dependency in the image?):
django.core.exceptions.ImproperlyConfigured: Error loading MySQLdb module.
Did you install mysqlclient?

Expected
Papermerge launches.

Actual
Papermerge crashes with the above mentioned exception

Info:

OS: Docker
Browser -
Database MySQL
Papermerge Version 2.1.9

Originally created by @philiplb on GitHub (Sep 22, 2023). Original GitHub issue: https://github.com/ciur/papermerge/issues/555 Originally assigned to: @ciur on GitHub. **Description** When starting a container with the image `papermerge/papermerge:2.1.9` with `PAPERMERGE__DATABASE__TYPE=mysql`, I get the following error (due to a missing dependency in the image?): django.core.exceptions.ImproperlyConfigured: Error loading MySQLdb module. Did you install mysqlclient? **Expected** Papermerge launches. **Actual** Papermerge crashes with the above mentioned exception **Info:** - OS: Docker - Browser - - Database MySQL - Papermerge Version 2.1.9

kerem

2026-02-25 21:31:54 +03:00

closed this issue
added the
bug
label

kerem commented

2026-02-25 21:31:55 +03:00

Author

Owner

@ciur commented on GitHub (Dec 29, 2023):

Please try version 3.0, as it supports mysql/mariadb: https://docs.papermerge.io/3.0/setup/docker-compose/
You'll need to use database url with mysql scheme.

@ciur commented on GitHub (Dec 29, 2023): Please try version 3.0, as it supports mysql/mariadb: https://docs.papermerge.io/3.0/setup/docker-compose/ You'll need to use [database url](https://docs.papermerge.io/3.0/settings/database/#database__url) with mysql scheme.

kerem commented

2026-02-25 21:31:55 +03:00

Author

Owner

@philiplb commented on GitHub (Dec 29, 2023):

Thank you very much! Unfortunately I settled.with a different system. But will try this eventually.

@philiplb commented on GitHub (Dec 29, 2023): Thank you very much! Unfortunately I settled.with a different system. But will try this eventually.