From 40709befd7f87ec702bc848fd8b165c8a6268f69 Mon Sep 17 00:00:00 2001 From: openhands Date: Tue, 10 Mar 2026 18:47:01 +0000 Subject: [PATCH 1/8] Add Windows 11 setup video link to local setup documentation This commit adds a link to a step-by-step Windows setup tutorial video in the local setup documentation under the Windows section. Fixes #16 --- openhands/usage/run-openhands/local-setup.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/openhands/usage/run-openhands/local-setup.mdx b/openhands/usage/run-openhands/local-setup.mdx index f4bea61d3..81433f005 100644 --- a/openhands/usage/run-openhands/local-setup.mdx +++ b/openhands/usage/run-openhands/local-setup.mdx @@ -62,6 +62,10 @@ A system with a modern processor and a minimum of **4GB RAM** is recommended to The docker command below to start the app must be run inside the WSL terminal. Use `wsl -d Ubuntu` in PowerShell or search "Ubuntu" in the Start menu to access the Ubuntu terminal. + + Looking for a video guide? Check out this [step-by-step Windows setup tutorial](https://youtu.be/Kp40Qqz4ZPw). + + From 5223c7e10dc59def05d48bb32da98a51b0ac4840 Mon Sep 17 00:00:00 2001 From: Jamie Chicago <87397251+jamiechicago312@users.noreply.github.com> Date: Tue, 10 Mar 2026 13:51:27 -0500 Subject: [PATCH 2/8] Apply suggestion from @jamiechicago312 --- openhands/usage/run-openhands/local-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openhands/usage/run-openhands/local-setup.mdx b/openhands/usage/run-openhands/local-setup.mdx index 81433f005..f70b96f42 100644 --- a/openhands/usage/run-openhands/local-setup.mdx +++ b/openhands/usage/run-openhands/local-setup.mdx @@ -3,7 +3,7 @@ title: Setup description: Getting started with running OpenHands on your own. --- -## Recommended Methods for Running Openhands on Your Local System +## Recommended Methods for Running OpenHands on Your Local System ### System Requirements From bf210018a23ccfbbd098c9b9e61a16381244d210 Mon Sep 17 00:00:00 2001 From: openhands Date: Tue, 10 Mar 2026 18:55:12 +0000 Subject: [PATCH 3/8] Reorganize Windows section: video link at top for easy access Moved the Windows setup video link to the top of the Windows accordion so users can find it immediately. The note about running docker in WSL stays at the end of the Windows section. Fixes #16 --- openhands/usage/run-openhands/local-setup.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/openhands/usage/run-openhands/local-setup.mdx b/openhands/usage/run-openhands/local-setup.mdx index f70b96f42..02aa6d41e 100644 --- a/openhands/usage/run-openhands/local-setup.mdx +++ b/openhands/usage/run-openhands/local-setup.mdx @@ -39,6 +39,10 @@ A system with a modern processor and a minimum of **4GB RAM** is recommended to + + Looking for a video guide? Check out this [step-by-step Windows setup tutorial](https://youtu.be/Kp40Qqz4ZPw). + + **WSL** 1. [Install WSL](https://learn.microsoft.com/en-us/windows/wsl/install). @@ -62,10 +66,6 @@ A system with a modern processor and a minimum of **4GB RAM** is recommended to The docker command below to start the app must be run inside the WSL terminal. Use `wsl -d Ubuntu` in PowerShell or search "Ubuntu" in the Start menu to access the Ubuntu terminal. - - Looking for a video guide? Check out this [step-by-step Windows setup tutorial](https://youtu.be/Kp40Qqz4ZPw). - - From fb3a73c9e486a63a82c838ce0846f2a35cf14024 Mon Sep 17 00:00:00 2001 From: openhands Date: Tue, 10 Mar 2026 19:02:57 +0000 Subject: [PATCH 4/8] Add OS-specific prerequisites to CLI installation docs - Added Prerequisites section with MacOS, Linux, and Windows requirements - Added Windows setup video link in the prerequisites - Added Note about running commands in WSL for Windows users Fixes #16 --- openhands/usage/cli/installation.mdx | 34 +++++++++++++++++++++++++--- 1 file changed, 31 insertions(+), 3 deletions(-) diff --git a/openhands/usage/cli/installation.mdx b/openhands/usage/cli/installation.mdx index e846ba739..7ea241663 100644 --- a/openhands/usage/cli/installation.mdx +++ b/openhands/usage/cli/installation.mdx @@ -3,9 +3,37 @@ title: Installation description: Install the OpenHands CLI on your system --- - -**Windows Users:** The OpenHands CLI requires WSL (Windows Subsystem for Linux). Native Windows is not officially supported. Please [install WSL](https://learn.microsoft.com/en-us/windows/wsl/install) first, then run all commands inside your WSL terminal. - +## Prerequisites + +Before installing the OpenHands CLI, ensure your system meets the requirements: + + + + + - [Docker Desktop](https://docs.docker.com/desktop/setup/install/mac-install/) installed and running + + + + + - [Docker Desktop](https://docs.docker.com/desktop/setup/install/linux/) installed and running + + + + + - Windows 10/11 with [WSL](https://learn.microsoft.com/en-us/windows/wsl/install) installed + - Ubuntu (or another Linux distribution) installed via WSL + - [Docker Desktop](https://docs.docker.com/desktop/setup/install/windows-install/) with WSL integration enabled + + + Looking for a video guide? Check out this [step-by-step Windows setup tutorial](https://youtu.be/Kp40Qqz4ZPw). + + + + + + +**Windows users:** All commands below should be run inside the WSL terminal (Ubuntu). Use `wsl -d Ubuntu` in PowerShell or search "Ubuntu" in the Start menu to access the Ubuntu terminal. + ## Installation Methods From df7ce661fcbc0dee965109e58b295ab1e2abc881 Mon Sep 17 00:00:00 2001 From: Jamie Chicago <87397251+jamiechicago312@users.noreply.github.com> Date: Tue, 10 Mar 2026 14:08:54 -0500 Subject: [PATCH 5/8] Apply suggestions from code review --- openhands/usage/run-openhands/local-setup.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/openhands/usage/run-openhands/local-setup.mdx b/openhands/usage/run-openhands/local-setup.mdx index 20d69f5fb..d9c19425e 100644 --- a/openhands/usage/run-openhands/local-setup.mdx +++ b/openhands/usage/run-openhands/local-setup.mdx @@ -46,7 +46,7 @@ A system with a modern processor and a minimum of **4GB RAM** is recommended to **WSL** 1. [Install WSL](https://learn.microsoft.com/en-us/windows/wsl/install). - 2. Run `wsl --version` in powershell and confirm `Default Version: 2`. + 2. Run `wsl --version` in PowerShell and confirm `Default Version: 2`. **Ubuntu (Linux Distribution)** From 3948d09398febe7ccf421fade168c0e29481b58c Mon Sep 17 00:00:00 2001 From: Jamie Chicago <87397251+jamiechicago312@users.noreply.github.com> Date: Tue, 10 Mar 2026 14:11:42 -0500 Subject: [PATCH 6/8] Update installation.mdx --- openhands/usage/cli/installation.mdx | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/openhands/usage/cli/installation.mdx b/openhands/usage/cli/installation.mdx index 7ea241663..2426f6925 100644 --- a/openhands/usage/cli/installation.mdx +++ b/openhands/usage/cli/installation.mdx @@ -28,12 +28,13 @@ Before installing the OpenHands CLI, ensure your system meets the requirements: Looking for a video guide? Check out this [step-by-step Windows setup tutorial](https://youtu.be/Kp40Qqz4ZPw). + + **Windows users:** All commands below should be run inside the WSL terminal (Ubuntu). Use `wsl -d Ubuntu` in PowerShell or search "Ubuntu" in the Start menu to access the Ubuntu terminal. + + - -**Windows users:** All commands below should be run inside the WSL terminal (Ubuntu). Use `wsl -d Ubuntu` in PowerShell or search "Ubuntu" in the Start menu to access the Ubuntu terminal. - ## Installation Methods From a80e01524a92c7ba991f749abe3658b5e23d84f7 Mon Sep 17 00:00:00 2001 From: Jamie Chicago <87397251+jamiechicago312@users.noreply.github.com> Date: Tue, 10 Mar 2026 14:17:37 -0500 Subject: [PATCH 7/8] Update installation.mdx --- openhands/usage/cli/installation.mdx | 34 +++------------------------- 1 file changed, 3 insertions(+), 31 deletions(-) diff --git a/openhands/usage/cli/installation.mdx b/openhands/usage/cli/installation.mdx index 2426f6925..017379360 100644 --- a/openhands/usage/cli/installation.mdx +++ b/openhands/usage/cli/installation.mdx @@ -3,37 +3,9 @@ title: Installation description: Install the OpenHands CLI on your system --- -## Prerequisites - -Before installing the OpenHands CLI, ensure your system meets the requirements: - - - - - - [Docker Desktop](https://docs.docker.com/desktop/setup/install/mac-install/) installed and running - - - - - - [Docker Desktop](https://docs.docker.com/desktop/setup/install/linux/) installed and running - - - - - - Windows 10/11 with [WSL](https://learn.microsoft.com/en-us/windows/wsl/install) installed - - Ubuntu (or another Linux distribution) installed via WSL - - [Docker Desktop](https://docs.docker.com/desktop/setup/install/windows-install/) with WSL integration enabled - - - Looking for a video guide? Check out this [step-by-step Windows setup tutorial](https://youtu.be/Kp40Qqz4ZPw). - - - - **Windows users:** All commands below should be run inside the WSL terminal (Ubuntu). Use `wsl -d Ubuntu` in PowerShell or search "Ubuntu" in the Start menu to access the Ubuntu terminal. - - - - + +**Windows users:** All commands below should be run inside the WSL terminal (Ubuntu). Use `wsl -d Ubuntu` in PowerShell or search "Ubuntu" in the Start menu to access the Ubuntu terminal. We also have a [step-by-step video tutorial](https://youtu.be/Kp40Qqz4ZPw) available. + ## Installation Methods From 48a2af6121f91d8ddcc84d9c3918b0e6e7402e62 Mon Sep 17 00:00:00 2001 From: Jamie Chicago <87397251+jamiechicago312@users.noreply.github.com> Date: Tue, 10 Mar 2026 14:41:44 -0500 Subject: [PATCH 8/8] Update openhands/usage/run-openhands/local-setup.mdx Co-authored-by: OpenHands Bot --- openhands/usage/run-openhands/local-setup.mdx | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/openhands/usage/run-openhands/local-setup.mdx b/openhands/usage/run-openhands/local-setup.mdx index d9c19425e..5ac891dec 100644 --- a/openhands/usage/run-openhands/local-setup.mdx +++ b/openhands/usage/run-openhands/local-setup.mdx @@ -39,10 +39,9 @@ A system with a modern processor and a minimum of **4GB RAM** is recommended to - + Looking for a video guide? Check out this [step-by-step Windows setup tutorial](https://youtu.be/Kp40Qqz4ZPw). - - + **WSL** 1. [Install WSL](https://learn.microsoft.com/en-us/windows/wsl/install).