Appendix 1. Common problems and solutions

This section describes the errors most often encountered during the installation of the Service and actions to fix them.

Server IP-address and Docker conflict

If the server on which Docker is deployed has an IP address like 172.17.0.0/16, this leads to a conflict between the physical network and the default Docker network.

To change the Docker network, follow these steps.

Edit or create a new Docker config file daemon.json:

nano /etc/docker/daemon.json

Add to the config file the lines:

{
  "default-address-pools":
  [
    {"base":"10.10.0.0/16","size":24}
  ]
}

Restart Docker:

service docker restart

Check the changes:

docker network create foo
docker
| network inspect foo | grep Subnet

The result should be: Subnet: 10.10.1.0/24.

This algorithm works the same for Docker Compose.

Go to the container:

docker-compose run --rm clementine_auth sh

Check component availability:

curl clementine_auth:9000/version

Exit the container:

Ctrl+D

If the Service and dependent components are located on the same server, it may be necessary to open ports or launch them on the host network.