🚀 mage-mirror

March 16, 2026 · View on GitHub

The Fastest Way to Spin Up Magento + Warden + Hyvä — On macOS & Linux

Fresh installs, Hyvä auto-setup, remote cloning, Magento upgrades, and multi-store routing — all from one script.

One command. Zero frustration.

mage-mirror header

🏷️ Badges

GitHub stars GitHub forks GitHub issues GitHub license

🎥 Quick Demo

mage-mirror demo

🌟 What is mage-mirror?

mage-mirror is a high-speed Magento development environment generator built for Warden, Docker, and Hyvä.

It automates:

  • Fresh Magento installs
  • Hyvä theme installation
  • Cloning local or remote sites
  • Magento upgrades
  • Multi-store routing
  • SSH sync via rsync or tar
  • OpenSearch reconfiguration
  • Full Warden environment setup

Everything runs through:

  • _mage-mirror.sh
  • _mage-mirror.config

🏁 Quick Start

git clone https://github.com/j-scriptz/mage-mirror.git
cd mage-mirror
chmod +x _mage-mirror.sh

then

./_mage-mirror.sh

or

sh _mage-mirror.sh

Environment URLs:

🚀 Key Features

⚡ Fresh Magento Installs

  • Composer create-project
  • Admin creation
  • Hyvä auto-install
  • Sample data support
  • DI compile + static deploy
  • OpenSearch configuration

🔁 Clone Magento Sites

Supports:

  • Local SQL + env.php/config.php
  • Remote over SSH
  • Remote DB via mysqldump
  • Remote rsync/tar sync modes

Modes:

  • Code only
  • DB only
  • Code + DB
  • Code + DB (no media)
  • Full sync

⬆️ Magento Upgrade Mode

UPGRADE_MAGENTO=yes
UPGRADE_MAGENTO_VERSION=2.4.*

mage-mirror will:

  1. Import site
  2. Adjust Composer constraints
  3. Run composer update
  4. Run setup:upgrade
  5. Build static assets

🌐 Multi-Store Routing

DomainWebsite
app.mage.testbase
mage.testsubcats

Also:

  • Writes to /etc/hosts
  • Patches pub/index.php
  • Sets base URLs

⚙ Configuration: _mage-mirror.config

Example:

PROJECT_NAME=mage
MAGENTO_VERSION=2.4.*
INSTALL_HYVA=ask
WITH_SAMPLE_DATA=ask
USE_EXISTING_DB=ask
USE_RSYNC_MAGENTO=ask
USE_REMOTE_DB_DUMP=no
ENABLE_MULTISTORE=ask
UPGRADE_MAGENTO=ask
UPGRADE_MAGENTO_VERSION=2.4.*

Supports: yes, no, ask

🧪 Example Commands

Fresh install (Hyvä + sample data)

PROJECT_NAME=mage USE_EXISTING_DB=no WITH_SAMPLE_DATA=yes INSTALL_HYVA=yes ./_mage-mirror.sh

Clone from local dump

PROJECT_NAME=mage USE_EXISTING_DB=yes EXISTING_DB_SQL=db/site.sql EXISTING_ENV_PHP=config/env.php ./_mage-mirror.sh

Clone remote + upgrade

PROJECT_NAME=mage USE_EXISTING_DB=yes USE_RSYNC_MAGENTO=yes USE_REMOTE_DB_DUMP=yes UPGRADE_MAGENTO=yes UPGRADE_MAGENTO_VERSION=2.4.* ./_mage-mirror.sh

❤️ Optional: Jscriptz Subcats

Hyvä + Luma compatible subcategory card module:
https://mage.jscriptz.com/jscriptz-subcats.html

🤝 Contributing

PRs and feature requests welcome.

If mage-mirror saved you time:

⭐ Please star the repo — it helps visibility!

📄 License

GNU Public License v3.0