Repository files navigation

A development environment for Magento 2.

Magento DockerLab is intended to be an easy and fast Magento 2 Docker development environment setup. Some of the key features of this environment are:

• Setup a Magento 2 development environment in seconds.
• You can have the latest Magento 2 version (or whatever version you need) with one single line of command.
• Everything you need when it comes to Magento 2 dependencies.
• Turn on and off XDebug automatically with only one command.
• Many more features!

Magento DockerLab is a complete stack just for your convenience and it includes the following services out of the box:

• PHP
• Nginx
• MySQL (You can use MariaDB and Percona too)
• Redis
• RabbitMQ with RabbitMQ Management
• MailHog
• ElasticSearch
• Kibana (for data visualization in ElasticSearch)

• Linux
• macOS
• Windows (WSL2)

This setup assumes you are running Docker on a computer with at least 4GB of allocated RAM, a dual-core, and an SSD hard drive.Download & Install Docker Desktop.

This configuration has been tested on Linux.

This docker compose project is intended to make the developer's life easier when it comes to Magento 2 development environment. The Magento 2 installation process is very straightforward by using this project.

In many cases, when we are starting a new project or we just want to play around with Magento 2, we just need to setup a new environment without any complexity, configuration or anything like that. The problem is that most of the times we struggle so much with setting up a new environment that we give up in the middle of the process.

This docker compose has an automation to avoid any headaches when it comes to having a Magento 2 running in your local machine. Just follow the following steps:

With a vhost it becomes easier to install and run Magento 2.

• Open your terminal;
• Run> sudo vim /etc/hosts;
• Add the follwing line if it does not exist:127.0.0.1 ::1 magento2.test;
• Save the document.

This is very simple!

• Runbin/setup

Now go to your default browser and type the following address in the address bar:

https://magento2.test

Because of the SSL was a self-signed one the browser will complain about the risk of accessing this resource, blá, blá, blá. Just keep on accessing the website.

For each installation of this project you'll have a new Certified Authority (CA) file generated. You probably don't know exactly what this means and what's it importance of this file but, in a nutshell, I can say that this file makes your browser to trust your self-signed SSL certificate as if you had bought one.

To import the CA file you need to take the following steps:

• Go toSettings > Privacy and Security > Security > Manage Certificates > Authorities > Import.
• Navigate to the root project where your Magento was installed and go tovar/ssl/ca and choose the auto-generated filerootCA.pem.

• Go toPreferences > Privacy & Security > Certificates > View Certificates > Authorities > Import.

• Navigate to the root project where your Magento was installed and go tovar/ssl/ca and choose the auto-generated filerootCA.pem.

• That's it! Now the little locks in the left side of your browser's address bar is green and you are not going to be warned again about self-signed certificates for this project.

TBD

Running Docker on Linux should be pretty straight-forward. Note that you need to run somepost install commands as well asinstalling Docker Compose. These steps are taken care of automatically with Docker Desktop, but not on Linux.

You may have to increase a virtual memory map count on the host system. It is required byElasticsearch.

Add following line to/etc/sysctl.conf:

vm.max_map_count=262144

MIT