Skip to main content
Version: 2024.3

Docker-Based Installation

You can use Docker to set up a new Pimcore Installation. You don't need to have a PHP environment with composer installed.

Prerequisites​

  • Your user must be allowed to run docker commands (directly or via sudo).
  • You must have docker compose installed.
  • Your user must be allowed to change file permissions (directly or via sudo).

Follow These Steps​

  1. Choose a Package to Install and create the project via composer
    • We offer 2 different installation packages:
# demo package with exemplary blueprints (`pimcore/demo`)
docker run -u `id -u`:`id -g` --rm -v `pwd`:/var/www/html pimcore/pimcore:php8.2-latest composer create-project pimcore/demo my-project
# empty skeleton package for experienced developers (`pimcore/skeleton`).
docker run -u `id -u`:`id -g` --rm -v `pwd`:/var/www/html pimcore/pimcore:php8.2-latest composer create-project pimcore/skeleton my-project

  1. Go to your new project cd my-project/

  2. Part of the new project is a docker compose file

    • Run echo `id -u`:`id -g` to retrieve your local user and group id
    • Open the docker-compose.yaml file in an editor, uncomment all the user: '1000:1000' lines and update the ids if necessary
    • Start the needed services with docker compose up -d

  3. Install Pimcore and initialize the DB docker compose exec php vendor/bin/pimcore-install --mysql-host-socket=db --mysql-username=pimcore --mysql-password=pimcore --mysql-database=pimcore (for demo package the installation can take a while)

info

If you choose to install backend search (which is installed by default), you must also adapt the supervisor configuration and add the pimcore_search_backend_message receiver to build up the search index.

  1. ✔️ DONE - You can now visit your Pimcore instance:

Caching​

Make sure to use any sort of caching to improve performance. We recommend Redis cache storage.

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.

Automating the Installation Process​

For more information about ways to automate the installation process, have a look on Advanced Installation Topics.