Skip to content

Commit 220d487

Browse files
add working across file system section
1 parent 313bef3 commit 220d487

File tree

1 file changed

+19
-1
lines changed

1 file changed

+19
-1
lines changed

gitkraken-client/windows-subsystem-for-linux.md

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ taxonomy:
1212
Using <a href="https://learn.microsoft.com/en-us/windows/wsl/about" target="_blank">Windows Subsystem for Linux (WSL)</a>? GitKraken Client can work with repos stored on your WSL 2 file system when installed within the WSL 2 environment and using WSL’s built-in display server functionality, <a href="https://learn.microsoft.com/en-us/windows/wsl/tutorials/gui-apps" target="_blank">WSLg</a>, for GUI support.
1313

1414
<div class='callout callout--warning'>
15-
<p>Note: GitKraken Client does not currently support cross file system access for repos stored on both Windows and WSL 2 and should be installed on the operating system where your repos are stored for the best experience. You may still open cross file system repos at your own discretion. For more information, see the section on </p>
15+
<p>Note: GitKraken Client does not currently support cross file system access for repos stored on both Windows and WSL 2 and should be installed on the operating system where your repos are stored for the best experience. You may still open cross file system repos at your own discretion. For more information, see the section on <a href=""> </a></p>
1616
</div>
1717

1818
GitKraken Client will also detect where a repo is stored and allow you to open it in the proper version of GitKraken Client so you can better manage GitKraken when working with both Windows and WSL repos.
@@ -69,6 +69,10 @@ gitkraken
6969
```
7070
Note: If you choose to install GitKraken Client from the .tar.gz file, gitkraken must be installed on ```PATH``` for this command to work
7171
***
72+
73+
## Preferences for GitKraken on WSL 2
74+
75+
7276
## Known Issues
7377

7478
- <a href="" target="_blank">HiDPI Displays cause WSLg to inconsistently scale the UI</a>
@@ -83,5 +87,19 @@ For other errors, you may need to restart WSL. You can run the following command
8387
wsl --shutdown
8488
```
8589
Then, reopen your Linux distribution or GitKraken Client as administrator.
90+
***
8691

8792
## Working Across File Systems
93+
94+
Microsoft recommends against working across operating systems when using WSL 2, and GitKraken does not currently support cross file system access of repos. To better manage multiple installations of GitKraken, GitKraken will notify you when opening a repo across operating systems and allow you to directly open the repo in the recommended installation of GitKraken. When attempting to open a new repo that is on WSL 2 from GitKraken installed on Windows, or Windows from GitKraken installed on WSL 2, the following message will appear:
95+
96+
<img src="/wp-content/uploads/wsl-toast.png" srcset="/wp-content/uploads/[email protected]" class="img-bordered img-responsive center">
97+
98+
You will be asked to choose an option to proceed:
99+
- ```Open Help Center``` will take you to this page in your browser for information on how to set up GitKraken within WSL 2.
100+
101+
- ```Open with GitKraken on Ubuntu/Windows``` will open the repository you're attempting to open in the recommended version of GitKraken if installed in the operating system where the repository is stored. This will work for both Windows and WSL 2 repositories that are being access from a different operating system.
102+
103+
- ```Open Anyway``` will open the repository. Features may behave in unintended ways, simply not function, and performance may be severely degraded when opening from a different operating system.
104+
105+
- Closing the message will cancel opening the repository

0 commit comments

Comments
 (0)