Skip to main content
Version: 2026.1

System Requirements

Server Requirements​

For production, a *nix based system is highly recommended.

Have a look at the official Docker images and the docker-compose files in the skeleton and demo enterprise packages.

Web Server​

  • Apache >= 2.4
    • mod_rewrite
    • .htaccess support (AllowOverride All)
  • Nginx (see the skeleton nginx.conf for a working sample config)

PHP 8.5+​

Both mod_php and FCGI (FPM) are supported.

Required Settings, Modules, and Extensions​

  • imagick (if not installed, gd is used instead, but with fewer supported image types)
    • LCMS delegate for ImageMagick to prevent negative colors for CMYK images
  • phpredis (recommended cache backend adapter)
  • mysqli (PDO is still required for parameter mappings)

Database Server​

  • MariaDB >= 10.3
  • MySQL >= 8.0
  • Percona Server (supported versions: see MySQL)
  • AWS Aurora (supported versions: see MySQL)

Features​

  • InnoDB / XtraDB storage engine
  • Support for InnoDB fulltext indexes

Permissions​

All permissions on database level, specifically:

  • Select, Insert, Update, Delete table data
  • Create tables
  • Drop tables
  • Alter tables
  • Manage indexes
  • Create temp-tables
  • Lock tables
  • Execute
  • Create view
  • Show view

For installing the demo enterprise package, Create routine and Alter routine are additionally needed.

System Variables​

[mysqld]
innodb_file_per_table = 1

[mariadb]
plugin_load_add = ha_archive # optional but recommended, starting from MariaDB 10.1 archive format is no longer activated by default (check and adapt for MySQL or other database software)

Search Engine (Required for Pimcore Studio)​

Pimcore Studio uses the Generic Data Index bundle for search and indexing. One of the following search engines is required:

  • OpenSearch >= 2.7 (recommended)
  • Elasticsearch >= 8.0.0

See the Installation guide for Docker setup and configuration.

Mercure (Required for Pimcore Studio)​

Pimcore Studio uses Mercure for real-time updates (progress tracking, live notifications). A Mercure hub must be available and reachable by both the server and the browser.

The recommended setup uses the official Docker image (dunglas/mercure:latest) with an Nginx reverse proxy. See the Installation guide for configuration details.

All versions > 3 are supported.

Configuration​

# select an appropriate value for your data
maxmemory 768mb

# IMPORTANT! Other policies will cause random inconsistencies of your data!
maxmemory-policy volatile-lru
save ""

Pimcore uses the Symfony Messenger for background processing. As the number of elements grows, a robust queue system becomes important. RabbitMQ is recommended for its performance and scalability in managing high message volumes and complex workflows.

See Symfony Messenger for messenger configuration. For an example configuration, refer to the skeleton messenger config.

Operating System​

Ensure all required packages for proper locale support by PHP are installed. On Debian-based systems, install the required locale packages:

apt-get install locales-all

A reboot may be required on some systems.

Additional Server Software​

  • FFMPEG (>= 3)
  • Ghostscript (>= 9.16)
  • LibreOffice (>= 4.3)
  • Chromium/Chrome
  • xvfb
  • timeout (GNU core utils)
  • pdftotext (poppler utils)
  • inkscape
  • pngquant
  • optipng
  • jpegoptim
  • exiftool
  • Graphviz

All of these tools are pre-installed in the official Pimcore Docker images. For custom setups, install them with your distribution's package manager and make sure they are added to $PATH so Pimcore can find the executables — alternatively, you can manually configure the path for each application.

Browser Requirements​

Pimcore Studio supports the latest two versions of all four major desktop browsers at the time of a release:

  • Google Chrome (Recommended)
  • Mozilla Firefox
  • Microsoft Edge
  • Apple Safari

System Requirements Check​

A built-in tool gives you an overview of required and optional system requirements.

You can check via the CLI:

bin/console pimcore:system:requirements:check