Skip to content

Conversation

@cbagwell
Copy link

The default location that OpenHands looks for .openhands directory has moved in recent versions but the docs were not completely updated.

  • I have read and reviewed the documentation changes to the best of my ability.
  • If the change is significant, I have run the documentation site locally and confirmed it renders as expected.

Summary of changes

The container can either mount at /root/.openhands or set an env var to tell location. I went with /root to match an existing document update that shows running openhands-cli inside a docker container and also mounts at /root.

I have seen some reports in Github Issues and Slack of users confused why conversations are no longer lasting past a container restart and other confusion on behavior differences in $HOME/.openhands after upgrading.

@cbagwell cbagwell requested a review from mamoodi as a code owner January 31, 2026 01:11
@enyst
Copy link
Collaborator

enyst commented Feb 4, 2026

Thank you for the PR, @cbagwell ! It seems this wasn’t working indeed, but the docs had old images:

I’m not sure the openhands dir change may be necessary, WDYT?

@cbagwell
Copy link
Author

cbagwell commented Feb 4, 2026

The -v ~/.openhands:/root/.openhands part is still needed on top of that other much needed fix. Should be easy enough to confirm since you won't see conversations added to ~/.openhands with current docs.

I will rebase this PR's on top of latest docs in just a bit to make merge easier. #289 + this -v fix is actually what I'm currently using daily.

I am confused a bit on how my PR only has the 1 change. I thought I read latest docs on web and saw that it had the image name and tags finally fixed and so I made just the 1 line change; otherwise my intent was to submit PR to fix the image name + tag as well. But that doesn't really make sense based on dates on this PR and #289. So obviously my work needs triple checking. 😄

The default location that OpenHands looks for .openhands
directory has moved in recent versions but the docs were
not completely updated.
@enyst
Copy link
Collaborator

enyst commented Feb 5, 2026

cc: @mamoodi WDYT?

@cbagwell
Copy link
Author

cbagwell commented Feb 5, 2026

This is location that is now looking at ~/.openhands; which is /root/.openhands by default.

https://github.com/OpenHands/OpenHands/blob/main/openhands/app_server/config.py#L68

I know prior to upgrading to v1 that /.openhands was the correct mount location but I am not familiar with that older code base to know how or why it changed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants