Skip to content

🐳 Mappia Docker Images for Magento 2®

Mappia provides a suite of Docker images optimized for deploying Magento 2 in Kubernetes environments. These images are used by default with the Helm chart and Terraform modules. You can use these images with or without Mappia. For the mappia/magento2 images, we recommend you build the images yourself, however you can use mappia/magento2 to view and run stock Magento 2 stores anywhere you'd like.


mappia/magento-php

A lightweight, Alpine-based PHP image tailored for Magento 2. Includes all required PHP extensions for running Magento in production environments.

  • Variants:
    • cli: Used for command-line operations like setup, cron, and indexing.
    • fpm: Used for serving PHP via PHP-FPM in web requests.
  • PHP Versions:
    • cli-alpine8.4, PHP version suffix.
  • Versions:
    • 🌲 Evergreen Tags - cli-alpine8.4, updated weekly.
    • 🏔️ Mappia Versioned Tags - v0.7.1-cli-alpine8.4, fixed digest, unchanged after release.
    • ⏲️ Date Tags - 20250421-cli-alpine8.4 , fixed digest, however a new tag comes out every 7 days.

mappia/magento2

A prebuilt, Alpine-based image for Magento 2, optimized for performance and headless commerce deployments.

TIP

This image does not contain an env.php or any of the system dependencies like elasticsearch, opensearch, redis , mysql or mariadb. You should mount an env.php and run the system requirements alongside the image.

  • Variants:
    • cli: Used for command-line operations like setup, cron, and indexing.
    • fpm: Used for serving PHP via PHP-FPM in web requests.
  • Magento Versions:
    • cli-alpine2.4.7, Magento version suffix.
  • Versions:
    • 🌲 Evergreen Tags - cli-alpine2.4.7, updated weekly.
    • 🏔️ Mappia Versioned Tags - v0.7.1-cli-alpine2.4.7, fixed digest, unchanged after release.
    • ⏲️ Date Tags - 20250421-cli-alpine2.4.7 , fixed digest, however a new tag comes out every 7 days.

📄 Documentation and Resources


By using Mappia's Docker images, you can streamline Magento 2 deployments, ensure consistency across environments, and simplify DevOps workflows.