Skip to main content

Troubleshooting

Scenarios where Depot Test might fail to run, or emit errors, and how to tackle these.

Errors

IP address or IPv4 address pool issues​

Error: (HTTP code 404) driver not found - could not find an available, non-overlapping IPv4 address pool among the defaults to assign to the network

This error can occur when the Docker container launched by Depot Test is not able to assign an IP address to the container from available networks.

Depot Test launches use custom created Docker networks that should usually be automatically cleaned up. In some scenarios, via abnormal exits of the test run(s) the clean-up might not run, and in these cases excess docker networks could build up until saturation point.

Run docker network ls to list out all Docker networks. If you see excess networks named with the prefix depot-local this might be your problem.

Run docker network prune to clean up unused networks, run the docker network ls command again to verify the excess networks have been removed, and try to run Depot Test again.

An excess list of networks might look something like this:

NETWORK ID     NAME                                                  DRIVER    SCOPE
267aa258dc2c   bridge                                                bridge    local
931940396fdd   depot-local-8080_dynamo-8000_es-_psql-5432-3864.0     bridge    local
bc99e1fda8d7   depot-local-8080_dynamo-8000_es-_psql-5432-11103.0    bridge    local
de210c7edea0   depot-local-8080_dynamo-8000_es-_psql-5432-15621.0    bridge    local
50753f567334   depot-local-8080_dynamo-8000_es-_psql-5432-17972.0    bridge    local
00a75169157d   depot-local-8080_dynamo-8000_es-_psql-5432-17973.0    bridge    local

Unhealthy back-end​

Error looking like:

error while checking back-end health; assuming unhealthy yet

or:

FetchError with message: reason: connect ECONNREFUSED 127.0.0.1:PORT_NUMBER

Running an older JDK can cause issues with the Depot backend process starting up. We recommend installing Amazon Corretto 21 and ensuring your JAVA_HOME environment variable is setup to correctly point to it.

See Corretto 21 Downloads.

Setting your JAVA_HOME environment variable (check to see which path Corretto is installed to first):

export JAVA_HOME=/Library/Java/JavaVirtualMachines/amazon-corretto-21.jdk/Contents/Home