github/OpenHands
1
0
Fork 0
mirror of https://github.com/OpenHands/OpenHands.git synced 2025-12-26 05:48:36 +08:00
Code Issues Packages Projects Releases Wiki Activity
OpenHands/docs/modules/usage/troubleshooting/troubleshooting.md
Alex Bäuerle cd58194d2a
docs(docs): start implementing docs website (#1372) 
* docs(docs): start implementing docs website

* update video url

* add autogenerated codebase docs for backend

* precommit

* update links

* fix config and video

* gh actions

* rename

* workdirs

* path

* path

* fix doc1

* redo markdown

* docs

* change main folder name

* simplify readme

* add back architecture

* Fix lint errors

* lint

* update poetry lock

---------

Co-authored-by: Jim Su <jimsu@protonmail.com>
2024-04-29 10:00:51 -07:00

2.6 KiB
Raw Blame History

sidebar_position
sidebar_position
5

🚧 Troubleshooting

There are some error messages that get reported over and over by users. We'll try and make the install process easier, and to make these error messages better in the future. But for now, you can look for your error message below, and see if there are any workaround.

For each of these error messages there is an existing issue. Please do not open an new issue--just comment there.

If you find more information or a workaround for one of these issues, please open a PR to add details to this file.

:::tip If you're running on Windows and having trouble, check out our guide for Windows users :::

Unable to connect to docker

Symptoms

Error creating controller. Please check Docker is running using docker ps

docker.errors.DockerException: Error while fetching server API version: ('Connection aborted.', FileNotFoundError(2, 'No such file or directory'))

Details

OpenDevin uses a docker container to do its work safely, without potentially breaking your machine.

Workarounds

  • Run docker ps to ensure that docker is running
  • Make sure you don't need sudo to run docker see here

Unable to connect to SSH box

Symptoms

self.shell = DockerSSHBox(
...
pexpect.pxssh.ExceptionPxssh: Could not establish connection to host

Details

By default, OpenDevin connects to a running container using SSH. On some machines, especially Windows, this seems to fail.

Workarounds

  • Restart your computer (sometimes works?)
  • Be sure to have the latest versions of WSL and Docker
  • Try this reinstallation guide
  • Set -e SANDBOX_TYPE=exec to switch to the ExecBox docker container

Unable to connect to LLM

Symptoms

  File "/app/.venv/lib/python3.12/site-packages/openai/_exceptions.py", line 81, in __init__
    super().__init__(message, response.request, body=body)
                              ^^^^^^^^^^^^^^^^
AttributeError: 'NoneType' object has no attribute 'request'

Details

This usually happens with local LLM setups, when OpenDevin can't connect to the LLM server. See our guide for local LLMs for more information.

Workarounds

  • Check your LLM_BASE_URL
  • Check that ollama is running OK
  • Make sure you're using --add-host host.docker.internal=host-gateway when running in docker