Development
Troubleshooting
Please submit an Issue for any trouble you run into so we can build out this section.
I have trouble running tests due to an error referencing docker or permissions
This is most likely an issue due to your Docker installation. There can be a number of issues at play depending on your OS and setup. First make sure you have docker installed, the daemon is running, and your user has permission to use docker (is in the docker group). Beyond that, some suggestions for specific setups:
- Podman
-
Ensure
podman.socketis enabled both globally and for your--user. - Docker on Linux
-
Try temporarily setting
/var/run/docker.sockworld-writeable. - Docker on Mac
-
Make sure colima is running.
- Docker on Windows
-
Ensure Docker Desktop is running.
- SELinux
-
Try temporarily disabling SELinux with
sudo setenforce 0or running with "Ryuk" disabled by setting the env varTESTCONTAINERS_RYUK_DISABLED=true.