Skip to main content

Install Mautic using the Production Package on Debian 12

Install repository for PHP 8.1​

Mautic 5.0 requires PHP 8.0 or 8.1.

Install Sury's Debian repository:

sudo apt install -y lsb-release apt-transport-https ca-certificates curl && \
sudo wget -O "/etc/apt/trusted.gpg.d/php.gpg" "https://packages.sury.org/php/apt.gpg" && \
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | sudo tee "/etc/apt/sources.list.d/php.list" && \
sudo apt update

Install required packages​

Install the dependencies:

apt install apache2 mariadb-server php8.1 php8.1-{fpm,xml,mysql,imap,zip,intl,curl,gd,mbstring,bcmath} unzip

Configure MariaDB​

mysql_secure_installation

Create the DB and the user:

Generate a random password for the database and store it in an environment variable:

MYSQL_PASSWD=$(echo $RANDOM | md5sum | head -c 20)

To print the database password:

echo $MYSQL_PASSWD

Create the database and the user:

mysql --execute="CREATE DATABASE mautic; GRANT ALL PRIVILEGES ON mautic.* TO 'mautic'@'localhost' IDENTIFIED BY '${MYSQL_PASSWD}' WITH GRANT OPTION; FLUSH PRIVILEGES;"

Configure PHP-FPM​

Configure the recommended settings for PHP-FPM:

nano +c/date.timezone /etc/php/8.1/fpm/php.ini
date.timezone = Europe/Budapest
warning

Modify the values below to your needs!

sed -i 's/memory_limit = 128M/memory_limit = 512M/' /etc/php/8.1/fpm/php.ini && \
sed -i 's/upload_max_filesize = 2M/upload_max_filesize = 100M/' /etc/php/8.1/fpm/php.ini && \
sed -i 's/max_execution_time = 30/max_execution_time = 600/' /etc/php/8.1/fpm/php.ini && \
sed -i 's/post_max_size = 8M/post_max_size = 64M/' /etc/php/8.1/fpm/php.ini

Restart the PHP-FPM service to apply the settings:

systemctl restart php8.1-fpm.service

Apache​

Create the site config:

nano /etc/apache2/sites-available/mautic.conf
<VirtualHost *:80>

    ServerName mautic.example.com
    DocumentRoot /var/www/mautic/

    <Directory />
        Options FollowSymLinks
        AllowOverride All
    </Directory>

    <Directory /var/www/mautic/>
        Options FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        allow from all
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

Disable mpm_prefork:

sudo a2dismod mpm_prefork

Enable the required Apache modules:

a2enmod rewrite mpm_event proxy_fcgi setenvif

Enable PHP-FPM for Apache:

a2enconf php8.1-fpm

Enable the site:

a2ensite mautic.conf

Apply settings for Apache:

systemctl restart apache2

Install Mautic​

Download the latest archive:

wget https://github.com/mautic/mautic/releases/download/5.0.4/5.0.4.zip

Create the directory for Mautic:

mkdir /var/www/mautic

Extract the zip archive:

unzip -d /var/www/mautic/ 5.0.4.zip

Change the owner of the files:

chown -R www-data:www-data /var/www/mautic