-
Notifications
You must be signed in to change notification settings - Fork 12
docs: Fix Docker volume mount path for .openhands#286
docs: Fix Docker volume mount path for .openhands #286cbagwell wants to merge 1 commit intoOpenHands:main from
Conversation
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
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.
d70a732 to
6d0c5db
Compare
enyst
commented
Feb 5, 2026
cc: @mamoodi WDYT?
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.
The default location that OpenHands looks for .openhands directory has moved in recent versions but the docs were not completely updated.
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.