PHPackages                             tshabatyn/magento2-deployer-plus - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps & Deployment](/categories/devops)
4. /
5. tshabatyn/magento2-deployer-plus

ActiveLibrary[DevOps & Deployment](/categories/devops)

tshabatyn/magento2-deployer-plus
================================

Magento 2 deployment tool based on deployer.org

2.8.1(5y ago)07GPL-3.0PHP

Since Feb 25Pushed 5y agoCompare

[ Source](https://github.com/tshabatyn/magento2-deployer-plus)[ Packagist](https://packagist.org/packages/tshabatyn/magento2-deployer-plus)[ RSS](/packages/tshabatyn-magento2-deployer-plus/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (7)Versions (31)Used By (0)

Magento 2 Deployer Plus
=======================

[](#magento-2-deployer-plus)

[![Build Status](https://camo.githubusercontent.com/e7827c22ceb5c3c73c12da92c44d279a3b3407eab464399149eb7bff07e505c8/68747470733a2f2f7472617669732d63692e636f6d2f6a616c6f6775742f6d6167656e746f322d6465706c6f7965722d706c75732e7376673f6272616e63683d646576656c6f70)](https://travis-ci.com/jalogut/magento2-deployer-plus)

- Reliable fully-automated deployments tool for Magento 2.
- Zero downtime deployments on Magento versions >= 2.2
- Automating your deployments is as easy as defining the servers where you want to deploy to.

Motivation
----------

[](#motivation)

This project aims to offer a common solution for fully-automated deployments on all versions of Magento 2. This tool uses the well known [Deployer](https://deployer.org) and adds specific recipes for each Magento 2 version.

Important Features
------------------

[](#important-features)

- [Deployer](https://deployer.org) code syntax
- Super easy setup
- Deploy to multiple servers
- Zero Downtime (only Magento >= 2.2)
- Build and Deploy artifacts (only Magento >= 2.2)
- Secure rollbacks (only Magento >= 2.2)

Installation
------------

[](#installation)

```
composer require "jalogut/magento2-deployer-plus"

```

Setup
-----

[](#setup)

### Magento >= 2.1

[](#magento--21)

```
cp /jalogut/magento2-deployer-plus/deploy.php.sample_2_1 deploy.php

```

### Magento >= 2.2

[](#magento--22)

```
cp /jalogut/magento2-deployer-plus/deploy.php.sample_2_2 deploy.php

```

### Magento >= 2.2.5

[](#magento--225)

```
cp /jalogut/magento2-deployer-plus/deploy.php.sample_2_2_5 deploy.php

```

Usage
-----

[](#usage)

### Git deploys:

[](#git-deploys)

```
/dep deploy []

```

### Build artifact deploys: (only Magento >= 2.2)

[](#build-artifact-deploys-only-magento--22)

```
/dep build
/dep deploy-artifact []

```

Disclaimer
----------

[](#disclaimer)

### Build command

[](#build-command)

Build command can only be used if config propagation is properly configured. See Magento DevDocs:

- [Propagate config accross systems](http://devdocs.magento.com/guides/v2.2/config-guide/cli/config-cli-subcommands-config-mgmt-export.html)

Also check `app:config:dump` issue and workaround here:

- [PR #12410](https://github.com/magento/magento2/pull/12410)
- [Gist workaround](https://gist.github.com/jalogut/d72e0af6e10c502bff90423e66bf07b9)

Troubleshooting
---------------

[](#troubleshooting)

#### Js translations missing (magento versions >=2.1.3 <2.2.1)

[](#js-translations-missing-magento-versions-213-221)

- **Problem**: Known Magento issue when executing `setup:static-content:deploy` for several languages.
- **Github Issues**:

    - [7862](https://github.com/magento/magento2/issues/7862)
    - [10673](https://github.com/magento/magento2/issues/10673)
- **Solution**: Until that gets fixed in `2.2.1`, the only workaround is to execute `setup:static-content:deploy` individually for each language:

    ```
     // deploy.php
     task('files:static_assets', '
     	{{bin/php}} {{magento_bin}} setup:static-content:deploy en_US {{static_deploy_options}}
     	{{bin/php}} {{magento_bin}} setup:static-content:deploy de_CH {{static_deploy_options}}
     	{{bin/php}} {{magento_bin}} setup:static-content:deploy fr_FR {{static_deploy_options}}
     ');
    ```

#### Compilation error

[](#compilation-error)

- **Solution**: Increase php `memory_limit` configuration to 728M o 1024M

#### Static deploy error when setting a new template (if config propagation is not used)

[](#static-deploy-error-when-setting-a-new-template-if-config-propagation-is-not-used)

- **Problems**:

    - `[LogicException] Unable to load theme by specified key: 'Template'`
    - `@variable` is undefined in file
- **Reason**: If a new template is set, running `setup:upgrade` is required before executing `setup:static-content:deploy`
- **Solution**: Skip `setup:static-content:deploy` first time you deploy the new template:

    1. Temporary disable task `files:static_assets`

        ```
        // deploy.php
        task('files:static_assets')->onRoles('Skip');

        ```
    2. Perform a new release
    3. Enable back `files:static_assets` on your `deploy.php` file

        - Remove `task('files:static_assets')->onRoles('Skip');`
    4. Manually execute `files:static_assets`

        ```
        /dep files:static_assets []

        ```

    After that, future deployments will work without issues

Prerequisites
-------------

[](#prerequisites)

- PHP >= 7.0.8
- MAGENTO >= 2.1

ChangeLog
---------

[](#changelog)

[CHANGELOG.md](CHANGELOG.md)

Developers
----------

[](#developers)

- [Juan Alonso](https://github.com/jalogut)
- [Oscar Recio](https://github.com/osrecio)
- [Contributors](https://github.com/jalogut/magento2-deployer-plus/graphs/contributors)

Licence
-------

[](#licence)

[GNU General Public License, version 3 (GPLv3)](http://opensource.org/licenses/gpl-3.0)

Copyright
---------

[](#copyright)

(c) Juan Alonso

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity74

Established project with proven stability

 Bus Factor1

Top contributor holds 58.3% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~37 days

Recently: every ~91 days

Total

28

Last Release

1985d ago

Major Versions

0.2 → 1.02018-03-05

1.1.3 → 2.02018-07-03

### Community

Maintainers

![](https://www.gravatar.com/avatar/c9a951cded99963caa19e007737e044fed7fc6cf01d70de4df7bca6856df6a3f?d=identicon)[tshabatyn](/maintainers/tshabatyn)

---

Top Contributors

[![jalogut](https://avatars.githubusercontent.com/u/6410900?v=4)](https://github.com/jalogut "jalogut (56 commits)")[![osrecio](https://avatars.githubusercontent.com/u/1510831?v=4)](https://github.com/osrecio "osrecio (24 commits)")[![erfanimani](https://avatars.githubusercontent.com/u/930470?v=4)](https://github.com/erfanimani "erfanimani (5 commits)")[![renttek](https://avatars.githubusercontent.com/u/1931090?v=4)](https://github.com/renttek "renttek (3 commits)")[![danielozano](https://avatars.githubusercontent.com/u/7377826?v=4)](https://github.com/danielozano "danielozano (2 commits)")[![rikwillems](https://avatars.githubusercontent.com/u/5927342?v=4)](https://github.com/rikwillems "rikwillems (2 commits)")[![schmengler](https://avatars.githubusercontent.com/u/367320?v=4)](https://github.com/schmengler "schmengler (2 commits)")[![mzeis](https://avatars.githubusercontent.com/u/371060?v=4)](https://github.com/mzeis "mzeis (1 commits)")[![julienanquetil](https://avatars.githubusercontent.com/u/1108170?v=4)](https://github.com/julienanquetil "julienanquetil (1 commits)")

---

Tags

tooldeploydeploymentdeployermagento2

###  Code Quality

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/tshabatyn-magento2-deployer-plus/health.svg)

```
[![Health](https://phpackages.com/badges/tshabatyn-magento2-deployer-plus/health.svg)](https://phpackages.com/packages/tshabatyn-magento2-deployer-plus)
```

###  Alternatives

[jalogut/magento2-deployer-plus

Magento 2 deployment tool based on deployer.org

201415.5k](/packages/jalogut-magento2-deployer-plus)[rafaelstz/deployer-magento2

Magento 2 deployment tool based on deployer.org

5223.5k](/packages/rafaelstz-deployer-magento2)[easycorp/easy-deploy-bundle

The easiest way to deploy Symfony applications

468310.2k](/packages/easycorp-easy-deploy-bundle)[ngmy/webloyer

Webloyer is a Web UI for managing Deployer deployments

2181.1k](/packages/ngmy-webloyer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)