diff --git a/CHANGELOG.md b/CHANGELOG.md index 0fda7aa1a749..1ef4ca90c7d0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -24,6 +24,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - \[SDK\] The `resource_type` args now have the default value of `local` in task creation functions. The corresponding arguments are keyword-only now. () +- Windows Installation Instructions adjusted to work around ### Deprecated - TDB diff --git a/site/content/en/docs/administration/basics/installation.md b/site/content/en/docs/administration/basics/installation.md index 84bde0ac94ec..2fe1f4b299d8 100644 --- a/site/content/en/docs/administration/basics/installation.md +++ b/site/content/en/docs/administration/basics/installation.md @@ -127,8 +127,7 @@ For access from China, read [sources for users from China](#sources-for-users-fr ## Windows 10 - Install WSL2 (Windows subsystem for Linux) refer to [this official guide](https://docs.microsoft.com/windows/wsl/install-win10). - WSL2 requires Windows 10, version 2004 or higher. Note: You may not have to install a Linux distribution unless - needed. + WSL2 requires Windows 10, version 2004 or higher. After installing WSL2, install a Linux Distribution of your choice. - Download and install [Docker Desktop for Windows](https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe). Double-click `Docker for Windows Installer` to run the installer. @@ -137,6 +136,9 @@ For access from China, read [sources for users from China](#sources-for-users-fr [here](https://docs.docker.com/docker-for-windows/wsl/). Note: Check that you are specifically using WSL2 backend for Docker. +- In Docker Desktop, go to `Settings >> Resources >> WSL Integration`, and +enable integration with the Linux Distribution that you chose. + - Download and install [Git for Windows](https://github.com/git-for-windows/git/releases/download/v2.21.0.windows.1/Git-2.21.0-64-bit.exe). When installing the package please keep all options by default. @@ -145,7 +147,7 @@ For access from China, read [sources for users from China](#sources-for-users-fr - Download and install [Google Chrome](https://www.google.com/chrome/). It is the only browser which is supported by CVAT. -- Go to windows menu, find `Git Bash` application and run it. You should see a terminal window. +- Go to windows menu, find the Linux distribution you installed and run it. You should see a terminal window. - Clone _CVAT_ source code from the [GitHub repository](https://github.com/opencv/cvat). @@ -183,7 +185,7 @@ For access from China, read [sources for users from China](#sources-for-users-fr below: ```shell - winpty docker exec -it cvat_server bash -ic 'python3 ~/manage.py createsuperuser' + sudo docker exec -it cvat_server bash -ic 'python3 ~/manage.py createsuperuser' ``` If you don't have winpty installed or the above command does not work, you may also try the following: