Installation (Manual)

The following process assumes that Docker Engine and Docker Compose are correctly installed. Otherwise, you should have a look to the installation documentation before proceeding further. This is the only thing required in addition of a terminal.

For better performances with Magento2 on macOS, we suggest you to also install Docker Machine NFS. It adds some complexity as you are forced to use Docker Machine, but it definitely worth it.

Clone the repository

$ git clone git@github.com:EmakinaFR/docker-magento2.git magento2

Pay attention to the name of the directory where you are cloning the project: it will be the prefix of your containers. That's why we remove docker- in the example above. It didn't make sense to have a container with this kind of prefix...

It's also possible to download it as a ZIP archive.

Customize the configuration

Environment variables

Multiple environment variables are described inside the .env file. There is a dedicated page about this subject.

Nginx servers

An example configuration for Nginx is available in nginx/servers/magento.conf. You can describe your own in nginx/servers/custom.conf Your changes won't be reverted by an environment update.

PHP configuration

The php/conf.d/custom.ini file describes the custom configuration that will be used by PHP. You can edit it as you want, but any change will be reverted when the environment will be updated.

---

When you edit a configuration file (either PHP or Nginx), you have to restart your environment to let the services refresh their configuration.

Start the environment

$ make start

That's all! 🚀
If your hosts file is already updated, you can now access the custom virtual host with HTTPS.