dementev/prestashop-test-images repository overview

⁠PrestaShop Docker Images

All-in-one PrestaShop Docker images with Nginx + PHP-FPM on Alpine Linux. Each image ships with a specific PrestaShop release baked in and performs auto-installation on first start.

⁠Available Images

Base image: dementev/php-fpm-with-ext:<php>-fpm

Architectures: linux/amd64, linux/arm64

⁠Quick Start

docker run -d \
  -p 8080:80 \
  -e PS_DOMAIN=localhost:8080 \
  -e DB_SERVER=host.docker.internal \
  -e DB_NAME=prestashop \
  -e DB_USER=root \
  -e DB_PASSWD=secret \
  -e PS_INSTALL_AUTO=1 \
  -e PS_ERASE_DB=1 \
  -e PS_INSTALL_DB=1 \
  dementev/prestashop-test-images:ps82-php84

⁠Environment Variables

⁠Required for auto-install

⁠Installation control

⁠Admin account

⁠Localization

⁠Feature flags

⁠Architecture

Each image bundles:

• Nginx — serves static files and proxies PHP to FPM via Unix socket
• PHP-FPM — dynamic process manager (max 20 children)
• PrestaShop — baked into /var/www/html at build time

⁠Entrypoint flow (docker_run.sh)

1. Wait for MySQL to become available (if PS_INSTALL_AUTO=1)
2. Detect if PrestaShop is already installed (checks for settings.inc.php / parameters.php / parameters.yml)
3. Run pre-install scripts from /tmp/pre-install-scripts/ (if any)
4. Rename install and admin folders if custom names are set
5. Optionally drop and/or create the database
6. Run the PrestaShop CLI installer
7. Run post-install scripts from /tmp/post-install-scripts/ (if any)
8. Enable demo mode if requested
9. Start PHP-FPM, then Nginx in foreground

⁠Custom scripts

Mount executable scripts to run them during setup:

# Before PrestaShop installation
-v ./my-script.sh:/tmp/pre-install-scripts/my-script.sh

# After PrestaShop installation
-v ./my-script.sh:/tmp/post-install-scripts/my-script.sh

⁠PHP configuration

⁠Health check

Built-in health check via curl http://localhost/ping (interval: 5s, start period: 300s).

⁠Building Locally

docker build \
  --build-arg PS_VERSION=8.2.4 \
  --build-arg PHP_VERSION=8.4 \
  -t prestashop:ps82-php84 .

⁠Docker Compose Example

See docker-compose.test.yml for a full example with Traefik, MySQL, Adminer, Redis, Memcached, and Mailpit.

services:
  prestashop:
    build:
      context: .
      args:
        PS_VERSION: "8.2.4"
        PHP_VERSION: "8.4"
    environment:
      PS_DOMAIN: shop.localhost
      DB_SERVER: mysql
      DB_NAME: prestashop
      DB_USER: root
      DB_PASSWD: secret
      PS_INSTALL_AUTO: 1
      PS_ERASE_DB: 1
      PS_INSTALL_DB: 1
      PS_DEV_MODE: 1
      PS_FOLDER_ADMIN: admin-dev
    ports:
      - "8080:80"
    depends_on:
      mysql:
        condition: service_healthy

  mysql:
    image: mysql:8.0
    command: --disable-log-bin --default-authentication-plugin=mysql_native_password
    environment:
      MYSQL_ROOT_PASSWORD: secret
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 5s
      timeout: 5s
      retries: 10