Magento Tutorials

How to install Magento Devbox

Magento Devbox is a new development environment option that is built on Docker.

It is delivered to you, all packaged with everything you would need, within seconds. That includes Magento, Redis, Varnish, the web server, database… and anything that might be necessary for a project. The good thing is that even though Devbox is primarily intended for developers, you don’t need to be one to be able to use it. All you have to do is freely choose the mix of settings you like and you’ll receive a zipped file all pre-configured ready to use in Magento environment.

Inheriting from Docker – a lightweight alternative, Devbox’s strongest cart is the containerization which simplifies the installation of different services. Therefore, you can now run multiple isolated development environments installed with all kind of versions of services while consuming fewer of host machine’s resources. In fact, thanks to Docker’s containers, now you can reduce the memory consumption by just starting or stopping the environment for the project you’re working on.

Another big win for developer teams working on Magento is that Devbox is a consistent and easily replicated development environment. All members can quickly switch between projects with the same set of tools or share the project with each other. Thusly, you will have exactly the same development environment as your co-worker without “it’s not working on my desktop” things!

The selling point of Magento Devbox is that a brand new installation only takes about 15 minutes to get done. So let’s get Devbox to work!

Step 1: Set up Docker

– Install Docker

magento devbox


– Set up Docker file sharing

For Windows

magento devbox


  1. Right-click the Docker icon in the system tray.
  2. From the pop-up menu, click Settings.
  3. Click the Shared Drives tab.This tab page displays all drives that Docker currently knows about. Make sure you install Magento in a drive listed on this tab page.
  4. Select the checkbox next to the drive in which to install Magento.
  5. Click Apply.

For Mac OS

  1. Right-click the Docker logo.
  2. From the pop-up menu, click Preferences.
  3. In the Preferences dialog box, click the File Sharing tab.This tab page displays all shared directories that Docker currently knows about. Make sure you install Magento in a folder listed on this tab page.
  4. To add additional directories, follow the prompts on your screen or consult Docker documentation.

Step 2: Download Magento Devbox

Step 3:Install and configure Magento Devbox

After downloading a Zip file, extract it.

Then to run the scripts, you should open a DOS command prompt (Windows) or Terminal (Mac) window and change to the DevBox root folder.

The following DevBox scripts and configuration files are located in the root folder:

  • m2devbox-init.[bat|sh] which starts the DevBox installation.
  • m2devbox-reset.[bat|sh] which restarts the DevBox installation.You can run this script, for example, after you stop and start your computer or Docker. DevBox assigns new ports to services.
  • docker-compose.yml DevBox configuration file. Set static listen ports* so you don’t have to reconfigure PhpStorm every time you start DevBox.
  • Windows only:m2devbox-unison-sync.bat which runs Unison file synchronization. You should not run this script by itself; one of the other scripts starts it automatically.
  • Mac OS which opens an SSH tunnel to the Docker container so PhpStorm can connect to it.

*Set static listen ports 

By default, every time you start a Docker container, all listen ports are reassigned randomly. To cause DevBox to use the same listen ports every time you restart, you must modify docker-compose.yml before you initialize DevBox for the first time.

To set static listen ports:

  1. Open docker-compose.yml in a text editor.It’s located in the root directory to which you downloaded DevBox.
  2. Locate the ports: section.
  3. Precede the default listen port with a free port number followed by :An example:
       - "12345:80"
       - "54321:22"

    The preceding example causes the web container to listen on port 12345 and SSH to listen on port 54321.


See also:
How to Install Data Migration Tool in Magento 2


A knowledge craver who always strive to be wiser everyday.

Notify of

Most Voted
Newest Oldest
Inline Feedbacks
View all comments
4 months ago

Magento DevBox is a pre-configured, virtualized development environment for Magento, allowing developers to set up a development environment for Magento 2 quickly, I also want to develop geometry dash meltdown I also want to develop.

29 days ago

I agree with the author