> For the complete documentation index, see [llms.txt](https://docs.ionos.com/docker-machine-driver-1/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ionos.com/docker-machine-driver-1/docker/troubleshooting.md). # Troubleshooting Here is a quick troubleshooting guide which may help you to resolve issues you may be facing. We all know that sometimes things do not go according to the plan. ## Unable to verify the Docker daemon is listening... When running the following command: ``` docker-machine create --driver ionoscloud test-machine ``` you may be getting the following results: ``` Creating CA: /home/runner/.docker/machine/certs/ca.pem Creating client certificate: /home/runner/.docker/machine/certs/cert.pem Running pre-create checks... Creating machine... (test-machine) Creating SSH key... (test-machine) DataCenter Created (test-machine) IPBlock Reserved (test-machine) LAN Created (test-machine) Server Created (test-machine) Volume Attached to Server (test-machine) NIC Attached to Server (test-machine) 158.222.102.181 Waiting for machine to be running, this may take a few minutes... Detecting operating system of created instance... Waiting for SSH to be available... Detecting the provisioner... Provisioning with ubuntu(systemd)... Installing Docker... Copying certs to the local machine directory... Copying certs to the remote machine... Setting Docker configuration on the remote daemon... Error creating machine: Error running provisioning: Unable to verify the Docker daemon is listening: Maximum number of retries (10) exceeded ``` The resources on Ionos Cloud are created, but the machine is unable to verify the Docker daemon, even after a number of retries. If you run `docker-machine ls`, the output will probably be: ``` NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS test-machine - ionoscloud Running tcp://158.222.102.183:2376 Unknown Unable to query docker version: Cannot connect to the docker engine endpoint ``` The problem is incompatibilities between Docker version 20.10.0+ and Docker Machine version 0.16. This is the [official issue](https://github.com/docker/machine/issues/4858) on [GitHub Repository](https://github.com/docker/machine) of Docker Machine. To install an older version of Docker when using Docker Machine, please run the following command: ``` docker-machine create --driver ionoscloud --engine-install-url "https://releases.rancher.com/install-docker/19.03.9.sh" test-machine ``` The output should be similar to this: ``` Creating CA: /home/runner/.docker/machine/certs/ca.pem Creating client certificate: /home/runner/.docker/machine/certs/cert.pem Running pre-create checks... Creating machine... (test-machine) Creating SSH key... (test-machine) DataCenter Created (test-machine) LAN Created (test-machine) Server Created (test-machine) Volume Attached to Server (test-machine) NIC Attached to Server (test-machine) 158.222.102.181 Waiting for machine to be running, this may take a few minutes... Detecting operating system of created instance... Waiting for SSH to be available... Detecting the provisioner... Provisioning with ubuntu(systemd)... Installing Docker... Copying certs to the local machine directory... Copying certs to the remote machine... Setting Docker configuration on the remote daemon... Checking connection to Docker... Docker is up and running! To see how to connect your Docker Client to the Docker Engine running on this virtual machine, run: docker-machine env test-machine ``` When running `docker-machine ls`, the output should be similar to this: ``` NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS test-machine - ionoscloud Running tcp://158.222.102.185:2376 v19.03.9 ``` ## Debug Option Docker Machine has a `--debug` or `-D` option in order to get detailed output about the command running: ``` docker-machine -D create --driver ionoscloud test-machine ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.ionos.com/docker-machine-driver-1/docker/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.