PHPackages                             modestcoders/magento2-dockergento - 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. modestcoders/magento2-dockergento

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

modestcoders/magento2-dockergento
=================================

Commands to help you using magento2-dockergento

4.4.1(4y ago)2471865[17 issues](https://github.com/ModestCoders/magento2-dockergento/issues)[5 PRs](https://github.com/ModestCoders/magento2-dockergento/pulls)Shell

Since Oct 18Pushed 4y ago27 watchersCompare

[ Source](https://github.com/ModestCoders/magento2-dockergento)[ Packagist](https://packagist.org/packages/modestcoders/magento2-dockergento)[ RSS](/packages/modestcoders-magento2-dockergento/feed)WikiDiscussions master Synced today

READMEChangelog (5)DependenciesVersions (25)Used By (0)

Magento 2 Dockergento
=====================

[](#magento-2-dockergento)

Plug and play Magento 2 dev environments with docker. **Fastest performance ever** on Mac and Linux.

Performance Comparison
----------------------

[](#performance-comparison)

#### Up to 7x faster development experience on Mac compare to standard docker setups.

[](#up-to-7x-faster-development-experience-on-mac-compare-to-standard-docker-setups)

[ ![Dockergento speed comparison](docs/img/benchmark_comparison_video.png)](https://www.youtube.com/watch?v=qdUBuDCzHaA&list=PLBt8dizedSZBhcjTL8SM2PS2HEy0mFf5F)#### Check out all benchmarks

[](#check-out-all-benchmarks)

- [Benchmarks: Dockergento vs Standard Docker](docs/benchmarks.md)

#### Learn more about how that is achieved

[](#learn-more-about-how-that-is-achieved)

- [Overcoming Docker for Mac performance issues](docs/overcome_performance_issues.md)

---

What is dockergento?
--------------------

[](#what-is-dockergento)

Dockergento is just a bash script ready to use in Linux and Mac to be able to use docker with best native performance.

While performance might no be a problem for Linux, using this tool is the only way you can overcome performance issues on Mac. Dockergento allows you to have different configuration for each system while using the same workflow. So your whole team can work the same way no matter which computer they are using. It just works!

Supported Systems
-----------------

[](#supported-systems)

- Mac
- Linux

---

Video Tutorials
---------------

[](#video-tutorials)

If you do not like reading and prefer watching videos. Check out all video tutorials here:

- [Video Tutorials](./docs/video_tutorials.md)

---

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

[](#installation)

You only need 3 things on your local machine: `git`, `docker` and `dockergento`

### Install Docker

[](#install-docker)

Follow the installation steps for your system.

Mac1. Install Docker on [Mac](https://docs.docker.com/docker-for-mac/install/)
2. Configure `File Sharing` settings for the folder that contains your projects

    [![File Sharing Configuration](docs/img/file_sharing.png)](docs/img/file_sharing.png)
3. Optionally you can also apply these performance tweaks

    -

Linux1. Install docker

    - Install Docker on [Debian](https://docs.docker.com/engine/installation/linux/docker-ce/debian/)
    - Install Docker on [Ubuntu](https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/)
    - Install Docker on [CentOS](https://docs.docker.com/engine/installation/linux/docker-ce/centos/)
2. Configure permissions

    - [Manage Docker as a non-root user](https://docs.docker.com/install/linux/linux-postinstall/)

### Install dockergento console

[](#install-dockergento-console)

1. Clone this repo

    ```
    git clone https://github.com/ModestCoders/magento2-dockergento.git

    ```
2. Add `dockergento` bin into your `$PATH`

    ```
    sudo ln -s $(pwd)/magento2-dockergento/bin/dockergento /usr/local/bin/

    ```
3. Open a new terminal tab/window and check that `dockergento` works

    ```
    which dockergento
    dockergento

    ```

Project Setup
-------------

[](#project-setup)

Depending the type of project, you can use one of the following setups:

### Dockerize existing project

[](#dockerize-existing-project)

```
cd
dockergento setup

```

### New project

[](#new-project)

```
mkdir  && cd
dockergento setup
dockergento create-project

```

### Magento 2 github for contribution

[](#magento-2-github-for-contribution)

**Disclaimer:** Performance on Mac is slower here due to the huge amount of files in `app` (~20.000 files)

Workaround to improve performance on Mac1. Remove these lines on `docker-compose.dev.mac.yml`

    ```
        - ./app:/var/www/html/app:delegated
        - ./dev:/var/www/html/dev:delegated
        - ./generated:/var/www/html/generated:delegated
        - ./pub:/var/www/html/pub:delegated
        - ./var:/var/www/html/var:delegated

    ```
2. Sync `app` using `unison` container. Add this in `docker-compose.dev.mac.yml`

    ```
    unison:
      volumes:
        - ./app:/sync/app

    ```
3. Mirror not synced folders before executing composer the first time

    ```
    dockergento start
    dockergento mirror-host app dev generated pub var

    ```
4. If you are editing code in `app`, you need to start unison watcher to sync files between host and container.

    ```
    dockergento watch app/code/Magento/

    ```

```
git clone https://github.com/magento/magento2.git
cd magento2
dockergento setup

```

---

Usage
-----

[](#usage)

### Start Application

[](#start-application)

```
dockergento start
dockergento composer install
sudo vim /etc/hosts
// Add -> 127.0.0.1

```

Open `http://` in the browser 🎉�

### Workflow

[](#workflow)

See detailed documentation about development workflow with dockergento

- [Development Workflow](docs/workflow.md)

---

More Documentation
------------------

[](#more-documentation)

- [Multi store configuration](docs/multi_store.md)
- [PHPStorm + Xdebug Setup](docs/xdebug_phpstorm.md)
- [Grumphp setup](docs/grumphp_setup.md)
- [Docker images list](docs/docker_images.md)
- [Other customizations](docs/customizations.md)

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

[](#troubleshooting)

- [Troubleshooting](docs/troubleshooting.md)

---

ChangeLog
---------

[](#changelog)

- [CHANGELOG.md](CHANGELOG.md)

Developers
----------

[](#developers)

- [Juan Alonso](https://github.com/jalogut)
- [Daniel Lozano](https://github.com/danielozano)
- [Contributors](https://github.com/ModestCoders/magento2-dockergento/graphs/contributors)

Donations 🙏
-----------

[](#donations-)

We’ve worked very hard to implement this tool. If you find it useful and want to invite us for a beer, just click on the donation button. Thanks! 🍺

[![Donate](https://camo.githubusercontent.com/604e3db9c8751116b3f765aad0353ec7ded655bbe8aaacbc38d8c4a6b784b3ed/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f446f6e6174652d50617950616c2d677265656e2e737667)](juan.jalogut@gmail.com)

Resources
---------

[](#resources)

This project has been possible thanks to the following resources:

- [docker-magento](https://github.com/markoshust/docker-magento) by [@markshust](https://twitter.com/markshust)
- [Getting Started with Docker for Magento](https://nomadmage.com/product/getting-started-with-docker-for-magento-2/) by [@mostlymagic](https://twitter.com/mostlymagic)
- [Docker Background Sync](https://github.com/cweagans/docker-bg-sync) by [@cweagans](https://twitter.com/cweagans)

Licence
-------

[](#licence)

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

Copyright
---------

[](#copyright)

(c) ModestCoders

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity27

Limited adoption so far

Community26

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 63.6% 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 ~64 days

Recently: every ~113 days

Total

16

Last Release

1792d ago

Major Versions

3.5.0 → 4.0.02019-09-26

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/6410900?v=4)[Juan Alonso](/maintainers/jalogut)[@jalogut](https://github.com/jalogut)

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

---

Top Contributors

[![jalogut](https://avatars.githubusercontent.com/u/6410900?v=4)](https://github.com/jalogut "jalogut (147 commits)")[![danielozano](https://avatars.githubusercontent.com/u/7377826?v=4)](https://github.com/danielozano "danielozano (51 commits)")[![ihor-sviziev](https://avatars.githubusercontent.com/u/1873745?v=4)](https://github.com/ihor-sviziev "ihor-sviziev (26 commits)")[![sebastian-ehrling](https://avatars.githubusercontent.com/u/20629208?v=4)](https://github.com/sebastian-ehrling "sebastian-ehrling (4 commits)")[![arendarenko](https://avatars.githubusercontent.com/u/42036143?v=4)](https://github.com/arendarenko "arendarenko (2 commits)")[![osrecio](https://avatars.githubusercontent.com/u/1510831?v=4)](https://github.com/osrecio "osrecio (1 commits)")

---

Tags

dockerdocker-magentomacosxmagento2environmentdockermagento2dockergento

### Embed Badge

![Health badge](/badges/modestcoders-magento2-dockergento/health.svg)

```
[![Health](https://phpackages.com/badges/modestcoders-magento2-dockergento/health.svg)](https://phpackages.com/packages/modestcoders-magento2-dockergento)
```

###  Alternatives

[spatie/docker

Run a docker container in your PHPUnit tests

478120.2k12](/packages/spatie-docker)[ryoluo/sail-ssl

Laravel Sail plugin to enable SSL (HTTPS) connection with Nginx.

188672.6k2](/packages/ryoluo-sail-ssl)[jalogut/magento2-deployer-plus

Magento 2 deployment tool based on deployer.org

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

Run multiple Laravel Sail websites on your local environment

33269.5k](/packages/aschmelyun-fleet)[testcontainers/testcontainers

Testcontainers implementation in PHP

199184.7k17](/packages/testcontainers-testcontainers)[contributte/bootstrap

Extra contrib to nette/boostrap

111.5M3](/packages/contributte-bootstrap)

PHPackages © 2026

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