The following guide assumes you're using a typical LAMP environment. If you're using a different setup (eg. Nginx) or you're facing a problem, please visit the Installation Guide section.
1. System Requirements
Please have a look at System Requirements and ensure your system is ready for Pimcore.
2. Install Pimcore & Dependencies
The easiest way to install Pimcore is from your terminal using Composer. Change into the root folder of your project:
Please remember: project root != document root
Choose a Package to Install
We offer 2 different installation packages:
- a demo package with exemplary blueprints.
- an empty skeleton package for experienced developers.
1. Skeleton Package (only for experienced Pimcore developers)
COMPOSER_MEMORY_LIMIT=-1 composer create-project pimcore/skeleton my-project
COMPOSER_MEMORY_LIMIT=-1 composer create-project pimcore/demo my-project
Point the document root of your vhost to the newly created
/public folder (eg.
Keep in mind that Pimcore needs to be installed outside of the document root.
Specific configurations and optimizations for your web server are available here:
Pimcore requires write access to the following directories (relative to your project root):
If you're running the installation using a custom environment name, ensure you already have the right config files in place, e.g.
3. Create Database
mysql -u root -p -e "CREATE DATABASE project_database charset=utf8mb4;"
For further information please visit out DB Setup Guide
4. Launch Installer
This launches the interactive installer with a few questions. Make sure that you set the
memory_limit to at least
512M in your
Pimcore allows a fully automated installation process. Read more here: Advanced Installation Topics
Open Admin Interface
After the installer has finished, you can open the admin interface:
Debugging Installation Issues
The installer writes a log in
var/log which contains any errors encountered during the installation. Please have a look at the logs as a starting point when debugging installation issues.
5. Maintenance Cron Job
Maintenance tasks are handled with Symfony Messenger. The
pimcore:maintenance command will add the maintenance
messages to the bus and run them afterward immediately from the queue. However, it is recommended to set up independent workers that process the queues by running
bin/console messenger:consume pimcore_core pimcore_maintenance pimcore_image_optimize pimcore_asset_update (using e.g.
# this command needs to be executed via cron or similar task scheduler
# it fills the message queue with the necessary tasks, which are then processed by messenger:consume
*/5 * * * * /your/project/bin/console pimcore:maintenance
# it's recommended to run the following command using a process control system like Supervisor
# please follow the Symfony Messenger guide for a best practice production setup:
*/5 * * * * /your/project/bin/console messenger:consume pimcore_core pimcore_maintenance pimcore_image_optimize pimcore_search_backend_message --time-limit=300
Depending on installed and activated extensions, it might be necessary to add additional transports to the messenger consume command. Please look at the documentation of corresponding extensions for more details.
Keep in mind that the cron job has to run as the same user as the web interface to avoid permission issues (eg.
For information about how to handle failed jobs, see this section.
Make sure to use any sort of caching to improve performance. We recommend Redis cache storage.
6. Additional Information & Help
If you would like to know more about the installation process or if you are having problems getting Pimcore up and running, visit the Installation Guide section.
7. Further Reading
- Symfony Messenger
- Advanced Installation Topics
- Apache Configuration
- Nginx Configuration
- Database Setup
- Additional Tools Installation
Next up - Directories Structure