diff --git a/docs/docs.json b/docs/docs.json index 2576e25529..641d2639a1 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -26,7 +26,7 @@ "usage/installation", "usage/getting-started", "usage/key-features", - "usage/faq", + "usage/faqs", { "group": "OpenHands Cloud", "pages": [ @@ -44,7 +44,7 @@ ] }, { - "group": "Running OpenHands on Your Own", + "group": "Run OpenHands on Your Own", "pages": [ "usage/local-setup", "usage/how-to/gui-mode", diff --git a/docs/usage/cloud/cloud-ui.mdx b/docs/usage/cloud/cloud-ui.mdx index 4e58d782ed..108bc2aa18 100644 --- a/docs/usage/cloud/cloud-ui.mdx +++ b/docs/usage/cloud/cloud-ui.mdx @@ -19,6 +19,7 @@ The landing page is where you can: The Settings page allows you to: - [Configure GitHub repository access](/usage/cloud/github-installation#modifying-repository-access) for OpenHands. +- [Install the OpenHands Slack app](/usage/cloud/slack-installation). - Set application settings like your preferred language, notifications and other preferences. - Add credits to your account. - Generate custom secrets. diff --git a/docs/usage/cloud/slack-installation.mdx b/docs/usage/cloud/slack-installation.mdx index 31bf8578c2..5be898437c 100644 --- a/docs/usage/cloud/slack-installation.mdx +++ b/docs/usage/cloud/slack-installation.mdx @@ -5,7 +5,7 @@ description: This guide walks you through installing the OpenHands Slack app. ## Prerequisites -- Access to OpenHands Cloud +- Access to OpenHands Cloud. ## Installation Steps @@ -23,11 +23,11 @@ description: This guide walks you through installing the OpenHands Slack app. - **Make sure your Slack workspace admin/owner has installed OpenHands Slack App first** + **Make sure your Slack workspace admin/owner has installed OpenHands Slack App first.** Every user in the Slack workspace (including admins/owners) must link their Cloud OpenHands account to the OpenHands Slack App. To do this: 1. Visit [integrations settings](https://app.all-hands.dev/settings/integrations) in OpenHands Cloud. - 2. Click the button "Install Slack App". + 2. Click `Install OpenHands Slack App`. 3. In the top right corner, select the workspace to install the OpenHands Slack app. 4. Review permissions and click allow. diff --git a/docs/usage/faqs.mdx b/docs/usage/faqs.mdx index 820293fd5b..9b762f9267 100644 --- a/docs/usage/faqs.mdx +++ b/docs/usage/faqs.mdx @@ -8,26 +8,33 @@ icon: question ### I'm new to OpenHands. Where should I start? -1. **Quick Start**: Use [OpenHands Cloud](/usage/cloud/openhands-cloud) to get started quickly with [GitHub](/usage/cloud/github-installation), [GitLab](/usage/cloud/gitlab-installation), and [Slack](/usage/cloud/slack-installation) integration -2. **Local Setup**: If you prefer to run it on your own hardware, follow our [Getting Started guide](/usage/local-setup) -3. **First steps**: Complete the [start building tutorial](/usage/getting-started) to learn the basics - +1. **Quick start**: Use [OpenHands Cloud](/usage/cloud/openhands-cloud) to get started quickly with + [GitHub](/usage/cloud/github-installation), [GitLab](/usage/cloud/gitlab-installation), + and [Slack](/usage/cloud/slack-installation) integrations. +2. **Run on your own**: If you prefer to run it on your own hardware, follow our [Getting Started guide](/usage/local-setup). +3. **First steps**: Complete the [start building tutorial](/usage/getting-started) to learn the basics. ### Can I use OpenHands for production workloads? -OpenHands is meant to be run by a single user on their local workstation. It is not appropriate for multi-tenant deployments where multiple users share the same instance. There is no built-in authentication, isolation, or scalability. +OpenHands is meant to be run by a single user on their local workstation. It is not appropriate for multi-tenant +deployments where multiple users share the same instance. There is no built-in authentication, isolation, or scalability. -If you're interested in running OpenHands in a multi-tenant environment, check out the source-available, commercially-licensed [OpenHands Cloud Helm Chart](https://github.com/all-Hands-AI/OpenHands-cloud). +If you're interested in running OpenHands in a multi-tenant environment, check out the source-available, +commercially-licensed [OpenHands Cloud Helm Chart](https://github.com/all-Hands-AI/OpenHands-cloud). -Using OpenHands for work? We'd love to chat! Fill out [this short form](https://docs.google.com/forms/d/e/1FAIpQLSet3VbGaz8z32gW9Wm-Grl4jpt5WgMXPgJ4EDPVmCETCBpJtQ/viewform) to join our Design Partner program, where you'll get early access to commercial features and the opportunity to provide input on our product roadmap. +Using OpenHands for work? We'd love to chat! Fill out +[this short form](https://docs.google.com/forms/d/e/1FAIpQLSet3VbGaz8z32gW9Wm-Grl4jpt5WgMXPgJ4EDPVmCETCBpJtQ/viewform) +to join our Design Partner program, where you'll get early access to commercial features and the opportunity to provide +input on our product roadmap. ## Safety and Security ### It's doing stuff without asking, is that safe? -**Generally yes, but with important considerations.** OpenHands runs all code in a secure, isolated Docker container (called a "sandbox") that is separate from your host system. However, the safety depends on your configuration: +**Generally yes, but with important considerations.** OpenHands runs all code in a secure, isolated Docker container +(called a "sandbox") that is separate from your host system. However, the safety depends on your configuration: **What's protected:** - Your host system files and programs (unless you mount them using [this feature](/usage/runtimes/docker#connecting-to-your-filesystem)) @@ -35,12 +42,14 @@ Using OpenHands for work? We'd love to chat! Fill out [this short form](https:// - Other containers and processes **Potential risks to consider:** -- The agent can access the internet from within the container -- If you provide credentials (API keys, tokens), the agent can use them -- Mounted files and directories can be modified or deleted -- Network requests can be made to external services +- The agent can access the internet from within the container. +- If you provide credentials (API keys, tokens), the agent can use them. +- Mounted files and directories can be modified or deleted. +- Network requests can be made to external services. -For detailed security information, see our [Runtime Architecture](/usage/architecture/runtime), [Security Configuration](/usage/configuration-options#security-configuration), and [Hardened Docker Installation](/usage/runtimes/docker#hardened-docker-installation) documentation. +For detailed security information, see our [Runtime Architecture](/usage/architecture/runtime), +[Security Configuration](/usage/configuration-options#security-configuration), +and [Hardened Docker Installation](/usage/runtimes/docker#hardened-docker-installation) documentation. ## File Storage and Access @@ -49,20 +58,19 @@ For detailed security information, see our [Runtime Architecture](/usage/archite Your files are stored in different locations depending on how you've configured OpenHands: **Default behavior (no file mounting):** -- Files created by the agent are stored inside the Docker container -- These files are temporary and will be lost when the container is removed -- The agent works in the `/workspace` directory inside the container +- Files created by the agent are stored inside the runtime Docker container. +- These files are temporary and will be lost when the container is removed. +- The agent works in the `/workspace` directory inside the runtime container. **When you mount your local filesystem (following [this](/usage/runtimes/docker#connecting-to-your-filesystem)):** -- Your local files are mounted into the container's `/workspace` directory -- Changes made by the agent are reflected in your local filesystem -- Files persist after the container is stopped +- Your local files are mounted into the container's `/workspace` directory. +- Changes made by the agent are reflected in your local filesystem. +- Files persist after the container is stopped. Be careful when mounting your filesystem - the agent can modify or delete any files in the mounted directory. - ## Development Tools and Environment ### How do I get the dev tools I need? @@ -71,15 +79,18 @@ OpenHands comes with a basic runtime environment that includes Python and Node.j It also has the ability to install any tools it needs, so usually it's sufficient to ask it to set up its environment. If you would like to set things up more systematically, you can: -- **Use setup.sh**: Add a [setup.sh file](https://docs.all-hands.dev/usage/prompting/repository#setup-script) file to your repository, which will be run every time the agent starts -- **Use a custom sandbox**: Use a [custom docker image](/usage/how-to/custom-sandbox-guide) to initialize the sandbox - +- **Use setup.sh**: Add a [setup.sh file](/usage/prompting/repository#setup-script) file to + your repository, which will be run every time the agent starts. +- **Use a custom sandbox**: Use a [custom docker image](/usage/how-to/custom-sandbox-guide) to initialize the sandbox. ### Something's not working. Where can I get help? -1. **Check our troubleshooting guide**: Common issues and solutions are documented in [Troubleshooting](/usage/troubleshooting/troubleshooting) -2. **Search existing issues**: Check our [GitHub issues](https://github.com/All-Hands-AI/OpenHands/issues) to see if others have encountered the same problem -3. **Join our community**: Get help from other users and developers: +1. **Search existing issues**: Check our [GitHub issues](https://github.com/All-Hands-AI/OpenHands/issues) to see if + others have encountered the same problem. +2. **Join our community**: Get help from other users and developers: - [Slack community](https://join.slack.com/t/openhands-ai/shared_invite/zt-34zm4j0gj-Qz5kRHoca8DFCbqXPS~f_A) - [Discord server](https://discord.gg/ESHStjSjD4) -4. **Report bugs**: If you've found a bug, please [create an issue](https://github.com/All-Hands-AI/OpenHands/issues/new) with details about your setup and the problem +3. **Check our troubleshooting guide**: Common issues and solutions are documented in + [Troubleshooting](/usage/troubleshooting/troubleshooting). +4. **Report bugs**: If you've found a bug, please [create an issue](https://github.com/All-Hands-AI/OpenHands/issues/new) + and fill in as much detail as possible. diff --git a/docs/usage/local-setup.mdx b/docs/usage/local-setup.mdx index 1f0488851f..7e6abe8150 100644 --- a/docs/usage/local-setup.mdx +++ b/docs/usage/local-setup.mdx @@ -153,8 +153,6 @@ To enable search functionality in OpenHands: For more details, see the [Search Engine Setup](/usage/search-engine-setup) guide. -Now you're ready to [get started with OpenHands](/usage/getting-started). - ### Versions The [docker command above](/usage/local-setup#start-the-app) pulls the most recent stable release of OpenHands. You have other options as well: