Libraries installation issues¶
While this wizard tries to handle most of the things for you, it doesn’t check for all the proper native (non python) libraries to be installed. Before running this, please check you have the proper header and libraries installed and available for packages to be installed.
Libraries you would want to check:
- libjpeg (for JPEG support in
- zlib (for PNG support in
- postgresql (for
- libmysqlclient (for
The actual package name may vary depending on the platform / distribution you
are using; you should make sure you have the library headers file installed
(mostly contained in package with
-dev in its name: e.g.
The following are examples based on major distributions versions at the time of writing.
This may may vary over time with distribution changes and may be out of date / unsuitable for you distribution.
The rationale should stand over the time, though, even if package manager and packages may change name and if a package name does not match when your these commands, a quick search using your distribution package manager should help you to find the right name.
Debian / Ubuntu¶
sudo apt-get install libtiff5-dev libjpeg8-dev zlib1g-dev libfreetype6-dev
sudo apt-get install libpq-dev
sudo apt-get install libmysqlclient-dev
dnf install python3-devel gcc(or
dnf install python-devel gcc)
dnf install libtiff-devel libjpeg-devel libzip-devel freetype-devel lcms2-devel libwebp-devel zlib-devel
dnf install postgresql-devel
dnf install mysql-devel(or
yum install mariadb-devel)
CentOS / yum based distributions¶
yum install python3-devel gcc(or
yum install python-devel gcc)
yum install libjpeg-devel libpng-devel libtiff-devel freetype-devel zlib-devel
yum install postgresql-devel
yum install mysql-devel(or
yum install mariadb-devel)
Fixing libraries installation issues¶
If a native library is missing when installing a python package, the package installation may fail silently or the package may be missing some functionality (e.g.: if libjpeg is not installed Pillow will be compiled without JPEG support).
djangocms-installer tries to check for most common issues and will exit with
an exception in case of errors.
In case of package installation failure you can simply install the correct
library and execute
djangocms-installer again with the same parameters; if
the package is compiled with some functionality missing, you have to first
deinstall it (
pip uninstall *package-name*), then install the correct library
and the execute
pip install --upgrade --force-reinstall --no-deps djangocms-installer
For older Debian / Ubuntu releases, a manual fix may be needed to properly fix compilation issues: see stackoverflow