Files
wehub-resource-sync 4e0f4422d0
build-docs / deploy (push) Has been cancelled
Check Markdown links / markdown-link-check (push) Has been cancelled
Pytest / test (3.11) (push) Has been cancelled
Pytest / test (3.12) (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 13:25:42 +08:00

27 lines
1.4 KiB
Markdown

# Installation troubleshooting
## Docker issues <a name="docker"></a>
First, test if you can use docker in general, for example by running
```bash
docker run hello-world
```
If you get an error like
```
docker: permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock:
Head "http://%2Fvar%2Frun%2Fdocker.sock/_ping": dial unix /var/run/docker.sock: connect: permission denied.
```
* Make sure that you allow the use of the Docker socket. In Docker desktop, click *Settings* > *Advanced* > *Allow the default Docker socket to be used (requires password)*.
* On the command line, you can try `sudo chmod 666 /var/run/docker.sock` or add your user to the `docker` linux user group
* If your docker installation uses a different socket, you might have to symlink them, see [this command for example](https://github.com/SWE-agent/SWE-agent/issues/20#issuecomment-2047506005)
If you are using any containers from dockerhub (i.e., you ran `docker pull ...` or you are running `docker run ...`), please make sure that you are using the latest
versions. Just because an image has the `latest` tag (e.g., `sweagent/swe-agent-run:latest`) does not mean that it will auto-update. Please run
`docker pull sweagent/swe-agent-run:latest` to make sure you actually have the most recent version!
Any remaining issues? Please [open a GitHub issue](https://github.com/SWE-agent/SWE-agent/issues/new/choose)!