Skip to main content
Version: 2023.1

Advanced Installation Topics

To fully automate the installation process, options can be passed in the CLI as parameters, rather than adding them interactively.

For Docker installation:
docker compose exec php vendor/bin/pimcore-install --admin-username=admin --admin-password=admin \
--mysql-username=username --mysql-password=password --mysql-database=pimcore \
--mysql-host-socket= --mysql-port=3306 \
For webserver installation:
./vendor/bin/pimcore-install --admin-username=admin --admin-password=admin \
--mysql-username=username --mysql-password=password --mysql-database=pimcore \
--mysql-host-socket= --mysql-port=3306 \

The --no-interaction flag will prevent any interactive prompts.

To avoid having to pass sensitive data (e.g. DB password) as command line option, you can also set each parameter as env variable. See ./vendor/bin/pimcore-install for details. Example:

$ PIMCORE_INSTALL_MYSQL_USERNAME=username PIMCORE_INSTALL_MYSQL_PASSWORD=password ./vendor/bin/pimcore-install \
--admin-username=admin --admin-password=admin \
--mysql-database=pimcore \

Installing Bundles

The --install-bundles flag will install and enable the specified bundles.
Attention: The bundles will be added to config/bundles.php automatically.

./vendor/bin/pimcore-install --admin-username=admin --admin-password=admin \
--mysql-username=username --mysql-password=password --mysql-database=pimcore \
--mysql-host-socket= --mysql-port=3306 \
--install-bundles=PimcoreApplicationLoggerBundle,PimcoreCustomReportsBundle \

Available bundles for installation:

Adding or Removing Bundles / Bundle Recommendations

Before bundles are displayed in the installation process, the BundleSetupEvent is fired. You can listen or subscribe to this event to add/remove bundles. Note that a recommendation will only be added if the bundle is already in the bundles list. For more info, you can take a look at the Pimcore Skeleton to see how the Admin UI Classic Bundle is installed.


namespace App\EventSubscriber;

use Pimcore\Bundle\AdminBundle\PimcoreAdminBundle;
use Pimcore\Bundle\InstallBundle\Event\BundleSetupEvent;
use Pimcore\Bundle\InstallBundle\Event\InstallEvents;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

class BundleSetupSubscriber implements EventSubscriberInterface
public static function getSubscribedEvents(): array
return [
InstallEvents::EVENT_BUNDLE_SETUP => [

public function bundleSetup(BundleSetupEvent $event): void
// add installable bundle and recommend it
$event->addInstallableBundle('PimcoreAdminBundle', PimcoreAdminBundle::class, true);

// add required bundle
$event->addRequiredBundle('PimcoreAdminBundle', PimcoreAdminBundle::class);

Make sure to register your listener/subscriber under config/installer.yaml as described in Preconfiguring the Installer.

# default configuration for services in *this* file
# automatically injects dependencies in your services
autowire: true
# automatically registers your services as commands, event subscribers, etc.
autoconfigure: true
# this means you cannot fetch services directly from the container via $container->get()
# if you need to do this, you can override this setting on individual services
public: false

# ---------------------------------------------------------
# Event Subscribers
# ---------------------------------------------------------
App\EventSubscriber\BundleSetupSubscriber: ~

Preconfiguring the Installer

You can preconfigure the values used by the installer by adding a config file which sets values for the database credentials. This is especially useful when installing Pimcore on platforms where credentials are available via env vars instead of having direct access to them. To preconfigure the installer, add a config file in config/installer.yaml (note: the file can be of any format supported by Symfony's config, so you could also use xml or php as the format), then configure the pimcore_installer tree:

# config/installer.yaml

user: username
password: password
dbname: pimcore

# env variables can be directly read with the %env() syntax
# see
host: "%env(DB_HOST)%"
port: "%env(DB_PORT)%"

Set a Timezone

Make sure to set the corresponding timezone in your configuration. It will be used for displaying date/time values in the admin backend.

timezone: Europe/Berlin

Office document preview

The feature for displaying a preview of documents directly in Pimcore is optional. To use it, you must install either Gotenberg or LibreOffice according to your preference.