Up until Mautic 4, users could download Mautic as a ZIP file and install it on any PHP server. However, many users were running into installation and update errors, many of which caused considerable frustration and in some cases, significant business disruption. Next to that, Mautic recently introduced the Marketplace which isn't compatible with this installation method.
For the reasons mentioned previously, from the release of Mautic 5, Composer becomes the default way to install and update Mautic. Read more in this blog post.
Before starting, it's good to understand that there's two aspects to Mautic:
When switching to a Composer-based installation, the database isn't touched, only the codebase.
In this tutorial, it's assumed that Mautic is currently installed in /var/www/html
.
Here's the steps to follow to switch to a Composer-based installation:
Go to /var/www
Run composer create-project mautic/recommended-project:^4 html-new --no-interaction
Copy the following files and folders from /var/www/html
to /var/www/html-new
:
app/config/local.php
- move to docroot/app/config/local.php
plugins
directory - move to docroot/plugins
app/media/files
and app/media/images
- move to docroot/app/media/files
and docroot/app/media/images
respectivelyapp/media/dashboards
- move to docroot/app/media/dashboards
themes
- move to /docroot/themes
translations
- move to /docroot/translations
Rename /var/www/html
to /var/www/html-old
and /var/www/html-new
to /var/www/html
When you're done, update your web server configuration to point to /var/www/html/docroot
instead of /var/www/html
Log into Mautic, and in your global settings, enable the switch to fully manage Mautic with Composer - this will also enable you to work with the Mautic Marketplace.
Q: Is existing data retained?
A: Yes. Switching to the Composer-based installation only affects app files. Nothing happens to your data.
Q: What's the minimum Mautic version required to switch to the Composer-based installation?
A: You need at least Mautic 4.0.0 for switching to the Composer-based installation.
Found errors? Think you can improve this documentation? edit this page