Magento DevBox

“Magento DevBox” is the name for a new Magento 2 development environment under development. It is being built by Magento as a standard way to develop Magento 2 sites for developers on a local development machine (a laptop or desktop). It is built upon Docker, but should not be confused with other Docker projects intended for production usage. Docker was a convenient technology to simplify the installation of a range of services that are frequently used with Magento 2 development.

There are a number of other great community solutions out there, each with different pros and cons. If you are using one of these environments there may not be a strong reason to consider Magento DevBox instead. Magento DevBox is not “magic” – it just follows our own installation guidelines. Magento DevBox will however become the default answer from Magento for “how do I get going with Magento 2 development?”

Why Magento DevBox?

Why are we putting together Magento DevBox? As the sophistication of Magento has increased (compared to Magento 1), the number of technologies needed has also increased. We have not found an existing MAMP or WAMP like installation with the right set of tools to make local installation of such tools easy.

Another benefit of Docker containerization is it is easier to have multiple development environments installed with different versions of services (e.g. different versions of PHP and MySQL when Magento 2 changes the supported versions sometime in the future). You just start and stop the environment for the project you are working on (to reduce memory consumption). This is trickier to configure when services are installed natively.

We have also heard the having a standardized environment from Magento can improve efficiency within the community. Developers trained on a standard environment can more quickly move between projects when the same set of tools and practices are followed.

What is Magento DevBox?

Magento DevBox is a pre-made development environment for Magento 2 built using Docker. It supports a range of Magento 2 releases (CE, EE, and ECE – Enterprise Cloud Edition – although ECE is not fully available yet), including the option to load sample data (useful for testing). As well as the core web server and MySQL instance, configuration options include developing with local Redis (data cache), Varnish (page cache), Elastic search (search technology), and RabbitMQ (message queue) instances.

How does it Work?

Magento DevBox is currently built using Docker 1.12 based on their promise of lightweight containers and native file sharing.

With Magento DevBox, project source files are left on the native host file system (Mac or Windows), allowing native IDEs to access the files directly. This provides the most responsive development environment of all the variations we have tested. This also allows the DevBox environment to be destroyed and recreated at any time, without risk of loss of code.

To create a new Magento DevBox environment, an online web form is provided which asks a number of questions about what tools you want to use (e.g. do you want Redis installed). The final result is a ZIP file with all configuration settings preconfigured. You download and extract this ZIP on your local file system. This includes getting the Magento 2 code base (for new projects) and automatic injection of download keys streamlining the download experience.

There have been some bumps however. The new file sharing approach introduced in Docker 1.12 has performance issues on Mac. This has been worked around within the Docker containers for now by use of Unison to synchronize files between the mounted directory and the web server directory. This is generally transparent to developers and will be removed if Docker improves the native file system performance. The main negative is additional startup time for the initial file system sync to complete.

Windows encountered different issues in that the Docker native file system support does not support “inotify” events, plus issues with file permissions when new files are created. Inotify support is very useful for tools such as Grunt and Gulp. Currently Windows leverages Unify again, but this time synchronizing between the native Windows file system and the container. This was the best option found so far from a wide range of tested options.

Usage documentation will be released with Magento DevBox.

Who Should Try Magento DevBox?

We are interested in a range of developers trying out Magento DevBox from experts to developers completely new to Magento. The goal is to simplify development for all developers. The defaults are intended to be suitable for new developers, with more options available for experts.

One particular note is inclusion of Varnish. A very common problem that has become apparent is developers are not testing sufficiently with Varnish in place, resulting in issues only being detected at the end of a project when rolled to production. Developers are therefore encouraged to perform local development with Varnish enabled. One useful piece of feedback is whether Varnish should be enabled by default for all development as a base expectation.


Magento DevBox is going to launch as a public beta shortly. The goal is to collect wider community feedback before it becomes “official”.

One of the interesting future areas of exploration is we are also prototyping creation of training environments based on Magento DevBox. The goal is to have the same development environment available, but preloaded with a database and exercise files as a starting point for tutorials.


  1. Stefano Hartmann · · Reply

    It looks like you just copied the idea from MGT-Commerce:

    1. Thanks for dropping some feedback. No, if you have been following my blog you will see experiments in this area for a long time. We finally got around to picking a winner solution. But its hardly a novel idea. It just was not needed in M1 because tools like MAMP and WAMP did a good enough job. But once you say “you should use Varnish during development to make sure caching is right” or “I want to use RabbitMQ on my project” it starts getting too complicated to describe how to install on Mac, Windows, Linux etc. This is just about making it easier for developers to get an environment up covering the tools we think developers may need. (Oh, Gulp/Grunt I want to do a bit more thinking about. This is coming out as a beta to see what people like, what we should change.)

    2. Christos Constantinou · · Reply

      Thanks for sharing MGT’s solution, however it would be much better for the community if Magento was maintaining this, so that the best practices come directly from Magento engineers and are up to date faster with every new Magento release.

  2. adamwebtise · · Reply

    Shame Docker on Mac doesn’t run as well as other OSs.

    Is gulp/grunt/node support baked into VM for developing on the front end?

    I was under the impression unison wouldn’t play well with grunt/gulp watch processes due to the file system events which they watch for not firing the same when using this method.

    1. Its good on Mac, but not perfect – it struggles with large numbers of files. But, its not perfect on Windows either – arguably worse. I am hopefully Docker team will continue to improve here. (It is a bit different to the more common Docker use case of managing production images etc. so I don’t really expect this to be #1 priority for the Docker team.)

      Unison works well with Gulp/Grunt, which is why we want that way. Unison is just doing standard file I/O and so triggers iNotify events. Decent Gulp/Grunt support is part of why this took so long to find a combination we were happy with. The negative of Unison is mainly the startup time and the occasional hiccup. Otherwise for me it has been working surprisingly well.

    2. Docker on OS X is definitely improving, though. I keep up with all updates and it runs quite well for me, no complaints.

  3. When you say “Shortly” Can you elaborate? I would love to start playing with this 🙂

    1. The code is fundamentally done, but a part of it is a online web interface that involves coordination with a different part of the org to get live. They have lots of other things on their list too. Feel free to reach out to Piotr directly, but my guess is “the next week or two”, but things always take longer than my optimistic expectations.

  4. Mohammed Abdul Hafeez · · Reply

    Is this the repository for Magento DevBox? If yes and as you mentioned light weight container then I would suggest Alpine instead of Ubuntu. Please let me know your thoughts.

  5. hafeez3000 · · Reply

    Is this the repository for Magento DevBox? If yes and as you mentioned light weight container then I would suggest Alpine instead of Ubuntu. Please let me know your thoughts.

    1. Production sites can value from super thin – but its less useful during development. Tools you want you keep find missing. This is why this is for development only, not production. Varnish, Redis, ElasticSearch etc however are separate containers in the current implementation – so if you don’t want them you don’t need them.

      I mean, not having unnecessary things is good (to save memory and disk etc). Finding the right balance is hard and I suspect no clear “right” answer. But I did find in the past some super thin containers did not even have ‘vi’, ‘more’, or ‘less’. It was just too painful.

      One question for me is whether we should be using NginX instead (or as well). I suspect so, especially for Magento Cloud users where NginX is used. Most of the Magento code does not care, but it is important for the whole project.

      1. hafeez3000 · ·

        I totally agree with you super thin are for production point, if you don’t mind still as a side note docker’s philosophy is build, package and ship the same from Development to Production. Moreover, If I refer to your answer for the question above “Who Should Try Magento DevBox?” common problem about the Varnish, when you are suggesting enable Varnish even during the development to avoid Caching issue surprises in the Production env. It is more reasonable to use the same setup of Docker even in Development that is super thin. Let me fork and try to see if I can do it on super thin even for develop development env (Just for fun).

        Regarding Nginx: Some of my thought and experiences are bundling Nginx and PHP-FPM as one container is preferable to over come file ownership and permission issues. However, if someone most expert in dealing the permissions the suggest to go with independent containers. To answer your question Nginx is more reasonable for considering as Webserver than Apache.

      2. Thanks for the comments. I understand “if you are doing a docker project, there is advantage of using the same images all the way through.” This is not such a project. There is not a single standard production setup, and frequently with hosting solutions like GoDaddy you deploy code, not Docker containers. So a project providing product Docker containers may recommend using their containers for development as well – and it would make sense.

        This project was “build a good development environment”. It just happens to use Docker. The native file sharing seemed ahead of Vagrant, VirtualBox etc – unfortunately ahead, but not yet “great”. So we are not focussing on Docker. And yes, I get lots of comments from Docker people “you are doing it wrong”. But I have done lots of experiments there for a year or two now. Docker is not our objective – its just a convenient tool. We are focussing on what fits Magento best.

      3. hafeez3000 · ·

        Totally understood, I heavily use Dockers for Magento Development environment, experimenting on new extension/module building and continues unit testing. I am glad to see your efforts in bringing Magento DevBox, this is a great move over other tools available to spin up Magento Instance for Development. I will follow the repository and try to contribute wherever it is possible.

      4. There is a GitHub issue tracker – that would be the best place to leave comments so they don’t get lost. It will connect more directly with the real engineers working on the project. (I dabble, they build.)

  6. Alan Kent, would definitely love to try. We’ve been using mgt-commerce, but their implementation is not complete (need manual adding redis, solr, elastic-search, etc). Please do let me know if you want us to try out and definitely when it is out.

    1. In case you did not notice, its out. Its on the page.

      1. Yup already on it.

  7. stefvossen · · Reply

    We’re using Docker for a while now for Magento2 development. One of the best performance boosts we got was to store the folders /vendor and /var inside a data volume instead of on the host. Since these folders are on .gitignore, they don’t have to be stored on the host. Although we rsync some subfolders of /vendor to the host when we start the Docker containers, to make it easier to look into the source code.

    With this setup we have acceptable performance with Docker for Mac and outstanding performance with dinghy/docker-machine.

  8. Why just not to use sshfs on osx? It should work well, is platform in-depended, can be later easily pointed to the real hosting env…

    1. We tried quite a few approaches. I have not tried sshfs, but have tried NFS and it was just too slow with PHP Storm. It does full file system scans periodically to index file contents, and the number of Magento files means the file system slow down is too painful.

      Also I personally prefer the files on my native file system so if the container goes crazy I don’t care – my files are safe on my laptop. I can blow away the containers and start again any time I like.

  9. apache? with php-fpm? very, very strange choice.

    1. Feel free to leave suggestions in the GitHub issue tracker for the project. We wanted to get what we had going out and collect feedback rather than continue behind closed doors. It works, but happy to build it up from here. E.g. NginX is an obvious question – should we have that as an option as well / instead.

  10. How I create a connection with MySQL Workbench ? I try to get the ip of the container or find it on configuration docker file but i cant find it.

    1. I would try – I don’t have practical experience with MySQL workbench so I would be guessing.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: