PHPackages                             justbetter/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 &amp; Deployment](/categories/devops)
4. /
5. justbetter/magento2-deployer-plus

AbandonedArchivedLibrary[DevOps &amp; Deployment](/categories/devops)

justbetter/magento2-deployer-plus
=================================

Magento 2 deployment tool based on deployer.org

1.1.8(2y ago)05.0k↓50%2GPL-3.0PHP

Since Mar 5Pushed 3mo agoCompare

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

READMEChangelog (10)Dependencies (1)Versions (12)Used By (0)

JustBetter - Magento 2 Deployer Plus
====================================

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

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

Archived
--------

[](#archived)

All features this offered are already available in deployer itself at this point [see](https://github.com/deployphp/deployer/blob/master/recipe/magento2.php)Migrate your deployments to use that instead.

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 &gt;= 2.2)
- Build and Deploy artifacts (only Magento &gt;= 2.2)
- Secure rollbacks (only Magento &gt;= 2.2)

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

[](#installation)

```
composer require justbetter/magento2-deployer-plus

```

Setup
-----

[](#setup)

### Magento &gt;= 2.1

[](#magento--21)

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

```

### Magento &gt;= 2.2

[](#magento--22)

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

```

### Magento &gt;= 2.2.5

[](#magento--225)

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

```

Usage
-----

[](#usage)

### Git deploys:

[](#git-deploys)

```
/dep deploy []

```

### Build artifact deploys: (only Magento &gt;= 2.2)

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

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

```

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

[](#troubleshooting)

#### Js translations missing (magento versions &gt;=2.1.3 &lt;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', function () {
     	run('{{bin/php}} {{magento_bin}} setup:static-content:deploy en_US {{static_deploy_options}}');
     	run('{{bin/php}} {{magento_bin}} setup:static-content:deploy de_CH {{static_deploy_options}}');
     	run('{{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 &gt;= 8.0
- MAGENTO &gt;= 2.1

ChangeLog
---------

[](#changelog)

[CHANGELOG.md](CHANGELOG.md)

Developers
----------

[](#developers)

- [Claudio Ferraro (JustBetter)](https://github.com/jbclaudio)
- [Contributors](https://github.com/justbetter/magento2-deployer-plus/graphs/contributors)

Licence
-------

[](#licence)

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

Copyright
---------

[](#copyright)

(c) JustBetter B.V.

###  Health Score

38

—

LowBetter than 84% of packages

Maintenance57

Moderate activity, may be stable

Popularity23

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 50% 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 ~0 days

Total

10

Last Release

793d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2d00b3f55cd4ae8b8cfb001a644ed6c7a1127a956c24375bcfe16ce12bd89bed?d=identicon)[justbetter](/maintainers/justbetter)

---

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)")[![claudio-ferraro](https://avatars.githubusercontent.com/u/54107647?v=4)](https://github.com/claudio-ferraro "claudio-ferraro (10 commits)")[![erfanimani](https://avatars.githubusercontent.com/u/930470?v=4)](https://github.com/erfanimani "erfanimani (6 commits)")[![sprankhub](https://avatars.githubusercontent.com/u/930199?v=4)](https://github.com/sprankhub "sprankhub (3 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)")[![norgeindian](https://avatars.githubusercontent.com/u/11156287?v=4)](https://github.com/norgeindian "norgeindian (1 commits)")[![indykoning](https://avatars.githubusercontent.com/u/15870933?v=4)](https://github.com/indykoning "indykoning (1 commits)")

---

Tags

tooldeploydeploymentdeployermagento2

### Embed Badge

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

```
[![Health](https://phpackages.com/badges/justbetter-magento2-deployer-plus/health.svg)](https://phpackages.com/packages/justbetter-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)
