diff --git a/docs/modules/usage/how-to/gui-mode.md b/docs/modules/usage/how-to/gui-mode.md index 483f8869e9eb..e2727e36deee 100644 --- a/docs/modules/usage/how-to/gui-mode.md +++ b/docs/modules/usage/how-to/gui-mode.md @@ -26,72 +26,77 @@ OpenHands automatically exports a `GITHUB_TOKEN` to the shell environment if it - **Locally (OSS)**: The user directly inputs their GitHub token. - **Online (SaaS)**: The token is obtained through GitHub OAuth authentication. -#### Setting Up a Local GitHub Token - -1. **Generate a Personal Access Token (PAT)**: +
+ Setting Up a Local GitHub Token + 1. **Generate a Personal Access Token (PAT)**: - Go to GitHub Settings > Developer Settings > Personal Access Tokens > Tokens (classic). - Click "Generate new token (classic)". - Required scopes: - `repo` (Full control of private repositories) - `workflow` (Update GitHub Action workflows) - `read:org` (Read organization data) - -2. **Enter Token in OpenHands**: + 2. **Enter Token in OpenHands**: - Click the Settings button (gear icon) in the top right. - Navigate to the "GitHub" section. - Paste your token in the "GitHub Token" field. - Click "Save" to apply the changes. +
-#### Organizational Token Policies +
+ Organizational Token Policies -If you're working with organizational repositories, additional setup may be required: + If you're working with organizational repositories, additional setup may be required: -1. **Check Organization Requirements**: + 1. **Check Organization Requirements**: - Organization admins may enforce specific token policies. - Some organizations require tokens to be created with SSO enabled. - Review your organization's [token policy settings](https://docs.github.com/en/organizations/managing-programmatic-access-to-your-organization/setting-a-personal-access-token-policy-for-your-organization). - -2. **Verify Organization Access**: + 2. **Verify Organization Access**: - Go to your token settings on GitHub. - Look for the organization under "Organization access". - If required, click "Enable SSO" next to your organization. - Complete the SSO authorization process. +
-#### OAuth Authentication (Online Mode) +
+ OAuth Authentication (Online Mode) -When using OpenHands in online mode, the GitHub OAuth flow: + When using OpenHands in online mode, the GitHub OAuth flow: -1. Requests the following permissions: + 1. Requests the following permissions: - Repository access (read/write) - Workflow management - Organization read access -2. Authentication steps: + 2. Authentication steps: - Click "Sign in with GitHub" when prompted. - Review the requested permissions. - Authorize OpenHands to access your GitHub account. - If using an organization, authorize organization access if prompted. - -#### Troubleshooting - -Common issues and solutions: - -- **Token Not Recognized**: - - Ensure the token is properly saved in settings. - - Check that the token hasn't expired. - - Verify the token has the required scopes. - - Try regenerating the token. - -- **Organization Access Denied**: - - Check if SSO is required but not enabled. - - Verify organization membership. - - Contact organization admin if token policies are blocking access. - -- **Verifying Token Works**: - - The app will show a green checkmark if the token is valid. - - Try accessing a repository to confirm permissions. - - Check the browser console for any error messages. - - Use the "Test Connection" button in settings if available. +
+ +
+ Troubleshooting + + Common issues and solutions: + + - **Token Not Recognized**: + - Ensure the token is properly saved in settings. + - Check that the token hasn't expired. + - Verify the token has the required scopes. + - Try regenerating the token. + + - **Organization Access Denied**: + - Check if SSO is required but not enabled. + - Verify organization membership. + - Contact organization admin if token policies are blocking access. + + - **Verifying Token Works**: + - The app will show a green checkmark if the token is valid. + - Try accessing a repository to confirm permissions. + - Check the browser console for any error messages. + - Use the "Test Connection" button in settings if available. +
### Advanced Settings diff --git a/docs/modules/usage/installation.mdx b/docs/modules/usage/installation.mdx index 6a65befc38f6..0b68bc2bb83a 100644 --- a/docs/modules/usage/installation.mdx +++ b/docs/modules/usage/installation.mdx @@ -88,12 +88,18 @@ The `Advanced Options` also allow you to specify a `Base URL` if required. settings-modal + +
+ Now you're ready to get started with OpenHands. +
+ ## Versions -The command above pulls the most recent stable release of OpenHands. You have other options as well: -- For a specific release, use `docker.all-hands.dev/all-hands-ai/openhands:$VERSION`, replacing $VERSION with the version number. -- We use semver, and release major, minor, and patch tags. So `0.9` will automatically point to the latest `0.9.x` release, and `0` will point to the latest `0.x.x` release. -- For the most up-to-date development version, you can use `docker.all-hands.dev/all-hands-ai/openhands:main`. This version is unstable and is recommended for testing or development purposes only. +The [docker command above](./installation#start-the-app) pulls the most recent stable release of OpenHands. You have other options as well: +- For a specific release, replace $VERSION in `openhands:$VERSION` and `runtime:$VERSION`, with the version number. +We use SemVer so `0.9` will automatically point to the latest `0.9.x` release, and `0` will point to the latest `0.x.x` release. +- For the most up-to-date development version, replace $VERSION in `openhands:$VERSION` and `runtime:$VERSION`, with `main`. +This version is unstable and is recommended for testing or development purposes only. You can choose the tag that best suits your needs based on stability requirements and desired features. diff --git a/docs/src/pages/index.tsx b/docs/src/pages/index.tsx index a2df79a259a5..797d45b39826 100644 --- a/docs/src/pages/index.tsx +++ b/docs/src/pages/index.tsx @@ -2,6 +2,7 @@ import useDocusaurusContext from '@docusaurus/useDocusaurusContext'; import Layout from '@theme/Layout'; import { HomepageHeader } from '../components/HomepageHeader/HomepageHeader'; import { translate } from '@docusaurus/Translate'; +import Link from '@docusaurus/Link'; export function Header({ title, summary }): JSX.Element { return ( @@ -23,6 +24,17 @@ export default function Home(): JSX.Element { })} > +
+
+

Most Popular Links

+ +
); }