Gave the <local> (but non-dev) install a spin this...
# feedback
h
Gave the local (but non-dev) install a spin this afternoon, so far so good. Here's a brief summary of my experience. - Before I could use it, I ran into the "Connection reset by peer" issue a couple of times initially with "Waiting for runtime". Otherwise the basic config was pretty straightforward. - Wrapping my head around the sandbox architecture took me the longest while first poking around. If there's one thing I'd suggest expanding on a bit in the docs, it's that. Basically, answering questions like: It's doing stuff without asking, is that safe? Where are my files stored? How do I get the dev tools I need? - My first test project was to try to build an app that was itself to be dockerized, so the agent immediately ran into not being able to run Docker. (It happily decided that I don't get to have what I can't have, and proceeded without. ;-) Now that I understand the architecture a bit better, that makes sense: I'd probably need a custom sandbox build for that kind of project. - I'm seeing "Agent is rate limited" increasingly frequently while asking it to do basic things. So far I just tell it manually "Continue" whenever that happens. 😛 This is with a Claude 4.0 Sonnet API key. Looks like https://github.com/All-Hands-AI/OpenHands/pull/9099 will at least make it easier to keep poking it. I've not tried hand-tuning the rate limit settings yet. That said, the sandbox is neat. I like how I can see what it's doing in the terminal, how it's taking screenshots, etc. I look forward to poking more :)
l
Thanks so much, this is great feedback!
💯 1
c
Good points. We do get quite a number of questions around where are files, and how to get them.
p
> I'd probably need a custom sandbox build for that kind of project you mean dind or docker outside docker?
c
OpenHands cloud actually supports docker-in-docker! Just tell it to setup docker!
@nutritious-balloon-65098 In the OpenHands repo's
docs/
folder, we should add a new FAQ page (next to "Docs" and "API Reference") that includes these common questions ("It's doing stuff without asking, is that safe?" Where are my files stored? How do I get the dev tools I need?") and points to a relevant documentation page that contains the answer.
n
I'm on it! Xingyao Wang can track my progress here.
Summary I have successfully created a comprehensive FAQ page for the OpenHands documentation that addresses the three specific questions you mentioned, plus additional helpful questions for new users. What I accomplished: Created a new FAQ page (
docs/usage/faq.mdx
) with comprehensive answers to: • "It's doing stuff without asking, is that safe?" - Explains sandbox security and isolation • "Where are my files stored?" - Details file storage and mounting options • "How do I get the dev tools I need?" - Explains custom Docker images and tool installation Added FAQ to navigation - Positioned early in the "Docs" tab for easy access (after Key Features) Grounded all answers in existing documentation with proper links to: • Runtime Architecture documentation (for sandbox safety) • Docker Runtime documentation (for file storage) • Custom Sandbox Guide (for development tools) • Getting Started, Troubleshooting, and other relevant pages Added helpful bonus questions covering getting started, troubleshooting, and production considerations Followed all requirements: • Pre-commit hooks installed and passing • Documentation follows existing format and style • Changes are concise and focused • All information properly sourced Pull Request Created Link: https://github.com/All-Hands-AI/OpenHands/pull/9132 The FAQ page is now ready for review and will help users quickly find answers to the most common questions about OpenHands' sandbox architecture, file handling, and development environment setup. Sources Referenced All content is based on existing OpenHands documentation: •
/usage/architecture/runtime.mdx
- Runtime architecture and sandbox security •
/usage/runtimes/docker.mdx
- File storage and mounting •
/usage/how-to/custom-sandbox-guide.mdx
- Development tools and custom images •
/usage/local-setup.mdx
- Getting started information •
/usage/troubleshooting/troubleshooting.mdx
- Help and troubleshooting resources
❤️ 2