You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: gitkraken-client/windows-subsystem-for-linux.md
+19-1Lines changed: 19 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,7 +12,7 @@ taxonomy:
12
12
Using <ahref="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, <ahref="https://learn.microsoft.com/en-us/windows/wsl/tutorials/gui-apps"target="_blank">WSLg</a>, for GUI support.
13
13
14
14
<divclass='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>
16
16
</div>
17
17
18
18
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
69
69
```
70
70
Note: If you choose to install GitKraken Client from the .tar.gz file, gitkraken must be installed on ```PATH``` for this command to work
71
71
***
72
+
73
+
## Preferences for GitKraken on WSL 2
74
+
75
+
72
76
## Known Issues
73
77
74
78
- <ahref=""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
83
87
wsl --shutdown
84
88
```
85
89
Then, reopen your Linux distribution or GitKraken Client as administrator.
90
+
***
86
91
87
92
## 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:
-```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