Skip to content

Commit cf26f5b

Browse files
add WSL host settings info
1 parent 220d487 commit cf26f5b

File tree

3 files changed

+17
-3
lines changed

3 files changed

+17
-3
lines changed

_images/wsl-host-settings.png

19.2 KB
Loading

_images/[email protected]

21.6 KB
Loading

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

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,15 +7,20 @@ taxonomy:
77

88
---
99

10+
## Working with WSL 2
11+
12+
<a href="https://learn.microsoft.com/en-us/windows/wsl/about" target="_blank">Windows Subsystem for Linux (WSL)</a>
13+
14+
## How to User GitKraken Client with WSL 2
1015
<img src="/wp-content/uploads/wsl-full-screen.png" srcset="/wp-content/uploads/[email protected]" class="img-bordered img-responsive center">
1116

12-
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.
17+
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. The Linux version of GitKraken client is upated to fix common issues when operating GitKraken within WSL 2, and includes settings to choose your preference for where to open web links, file editors, and file browsers.
1318

1419
<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 <a href=""> </a></p>
20+
<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. Opening repos across file systems </p>
1621
</div>
1722

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.
23+
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. For more information, see the section on <a href=""> </a>.
1924

2025
There are 4 steps to start using GitKraken Client with your WSL repos:
2126
1. Confirm the latest version of WSL 2 is installed that supports WSLg
@@ -72,6 +77,11 @@ Note: If you choose to install GitKraken Client from the .tar.gz file, gitkraken
7277

7378
## Preferences for GitKraken on WSL 2
7479

80+
When running GitKraken Client within WSL 2, additional preferences are available to tell GitKraken where you'd like to open URLs and files opened by GitKraken. You'll see these settings in ```Preferences``` > ```General``` when running within WSL 2.
81+
82+
<img src="/wp-content/uploads/wsl-host-settings.png" srcset="/wp-content/uploads/[email protected]" class="img-bordered img-responsive center">
83+
84+
By default, URLs will open in your Windows default browser and other files opened by GitKraken will attempt to open on the host distribution.
7585

7686
## Known Issues
7787

@@ -103,3 +113,7 @@ You will be asked to choose an option to proceed:
103113
- ```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.
104114

105115
- Closing the message will cancel opening the repository
116+
117+
<div class='callout callout--warning'>
118+
<p>Note: If you open a repository in WSL through a mapped network drive from Windows, GitKraken Client will not detect that the repository is being accessed across file systems and attempt to open normally. </p>
119+
</div>

0 commit comments

Comments
 (0)