Configuring Docker Daemon for EE4

In order for EasyEngine v4 to work seamlessly, there are a few changes you need to make to your docker’s daemon.json. These changes are required because of docker’s overlay network limitation. If these changes are not done, you may be limited to 27 sites on a server.

EasyEngine takes care of these changes in Linux and shows manual steps while installing in Mac, but in case you want to perform them manually, here is how you do them:

⚠️ Note: Before performing the following steps, ensure that your EasyEngine version is greater than 4.4.1

Change Docker Daemon Configuration

Linux

1. Open /etc/docker/daemon.json using your favorite editor

2. If the file is empty, add the following:

{
  "default-address-pools": [{"base":"10.0.0.0/8","size":24}]
}

If the file already contains some data, just add the key "default-address-pools": [{"base":"10.0.0.0/8","size":24}], being careful to add a comma to the end of the line if it is not the last line before the closing bracket.

3. Restart Docker daemon using the following commands:

sudo systemctl daemon-reload
sudo systemctl restart docker

Mac

1. Please open Docker Desktop and in the taskbar, go to Preferences > Daemon > Advanced.

2. If the file is empty, add the following:

{
  "default-address-pools": [{"base":"10.0.0.0/8","size":24}]
}

If the file already contains some data, just add the key "default-address-pools": [{"base":"10.0.0.0/8","size":24}], being careful to add a comma to the end of the line if it is not the last line before the closing bracket.

3. Restart Docker.