| Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
| other:win10wsl [2022/09/07 15:16] – [Restoring or relocating a Linux installation] Improved and cleaned jypeter | other:win10wsl [2022/09/08 16:40] – [Opening a terminal] Updated the WSLtty section jypeter |
|---|
| stdu@sadira034:~$ echo $SHELL | stdu@sadira034:~$ echo $SHELL |
| /bin/bash</code> | /bin/bash</code> |
| | |
| | * Note: after installing (even from the PowerShell command line), Ubuntu will appear as a regular installed application in the //Microsoft Store// and the list of applications |
| | * {{ :other:ubuntu_ms-store.png?direct&400 |}} |
| | * {{ :other:ubuntu_applications.png?direct&400 |}} |
| |
| * Get some basic information about your new ''Ubuntu'' installation | * Get some basic information about your new ''Ubuntu'' installation |
| === The default terminal === | === The default terminal === |
| |
| The **Default WSL+Ubuntu //terminal//** is basically a //bash// shell running inside a regular Windows ''cmd'' text console. You do not need to have an //X server// running to use it! | The **Default WSL+Ubuntu //terminal//** is basically a //bash// shell running inside a regular Windows ''cmd'' text console. You do not need to have an [[other:x_conf#using_an_x_server_on_windows|X server]] running to use it! |
| |
| There are several ways to open a default terminal: | There are several ways to open a default terminal: |
| |
| <note tip> | <note tip> |
| * This is the recommended (by JYP) option for now | * This is the recommended (by JYP) option for now, until we can use regular Linux select-copy/paste in the Windows Terminal ([[https://github.com/microsoft/terminal/issues/7646|Feature request: add xterm-style select/copy/paste options]]) |
| |
| * If you can't open a terminal after Windows upgrades from WSL to WSL v2, get and install the latest version of WSLtty ! | * If you can't open a WSLtty terminal after upgrading from ''WSL'' to ''WSL 2'', install the latest version of WSLtty ! |
| </note> | </note> |
| |
| [[https://github.com/mintty/wsltty|WSLtty]] allows you to use the efficient //Mintty// as a terminal for WSL. **You do not need to have an //X server// running to use it!** | [[https://github.com/mintty/wsltty|WSLtty]] allows you to use the efficient //Mintty// as a terminal for WSL. **You do not need to have an [[other:x_conf#using_an_x_server_on_windows|X server]] running to use it!** |
| |
| * Download and execute the latest [[https://github.com/mintty/wsltty/releases|64bit installer]] (the most recent ''wsltty-*-install-x86_64.exe'' file) | * Use [[https://github.com/mintty/wsltty#windows-package-manager|winget]] (in a PowerShell) to install WSLtty |
| * After installing, you will get several ways to open a terminal: | * <code>PS C:\Users\your_login> winget install wsltty |
| * Double-click on the ''WSL terminal'' icon on the desktop | Trouvé WSLtty [Mintty.WSLtty] Version 3.6.0 |
| * ''U''=>''Ubuntu terminal'' and ''W''=>''WSL Terminal'' in the ''Start'' menu | [...] |
| * There is also a ''W''=>''WSLtty'' folder, than you don't really need | Installé correctement</code> |
| | |
| | * After installing, you will get **several new ways to open a terminal**: |
| | * ''WSL terminal'' icon on the desktop |
| | * ''Start'' => ''U'' => ''Ubuntu terminal'' (or ''Ubuntu_custom terminal'' or something similar if you have [[other:win10wsl#restoring_or_relocating_a_linux_installation|restored/relocated a Linux installation]]) |
| | * ''Start'' => ''W'' => ''WSL Terminal'' in the ''Start'' menu |
| | * There is also a ''W'' => ''WSLtty'' folder, than you probably will not need (more details in [[https://github.com/mintty/wsltty#configuration|Configuration]]), except possibly ''configure WSL shortcuts'' (//run after adding or removing WSL distributions, in order to create the respective set of shortcuts in the Start menu//) |
| * Open a terminal and right-click in it to check the available options | * Open a terminal and right-click in it to check the available options |
| | * Hint: use the ''Text'' option to select the nice //Cascadia Code// font bundled with the [[other:win10apps#windows_terminal|Windows Terminal]] |
| * You can access even more options with CTRL+right-click | * You can access even more options with CTRL+right-click |
| * You can cycle between the open WSLtty terminals with CTRL+Tab and Shift+CTRL+Tab | * You can cycle between the open WSLtty terminals with CTRL+Tab and Shift+CTRL+Tab |
| === Terminals started from Linux === | === Terminals started from Linux === |
| |
| You can install additional //graphical// terminals inside the Linux running in WSL, but **you will need to have a running //X server// if you want to open them**. In these terminals, the //usual// Linux copy/paste rules will apply! | You can install additional //graphical// terminals inside the Linux running in WSL, but **you will need to have a running [[other:x_conf#using_an_x_server_on_windows|X server]] if you want to open them**. In these terminals, the //usual// Linux copy/paste rules will apply! |
| |
| == xterm == | == xterm == |
| root@sadira034:~# whoami | root@sadira034:~# whoami |
| root</code> | root</code> |
| | * If the //relocation// goal was to free up some space on ''C:'', it is possible to [[other:win10wsl#removing_the_main_linux_installation|Remove the main installation]], once the relocated installation has been successfully tested |
| |
| Questions FIXME | Questions FIXME |
| * Is it possible to restore to the default location (on ''C:\'') ? | * Is it possible to restore to the default location (on ''C:\'') ? |
| ==== Uninstalling WSL ==== | ==== Uninstalling WSL or a distribution ==== |
| |
| Before starting, you may want to make a backup of whatever you had in your Ubuntu home directory, and all the files and settings that are not in the ''/mnt'' directories | Before uninstalling //something//, you probably want to [[other:win10wsl#creating_a_backup|create a backup]], just to be safe... |
| |
| === Removing a specific Linux installation === | === Removing a specific Linux installation === |
| * Ubuntu Stopped 2</code> | * Ubuntu Stopped 2</code> |
| |
| | |
| | === Removing the main Linux installation === |
| | |
| | If you remove the main installation (on ''C:\''): |
| | * Another //relocated// installation will become the new default installation (if present) |
| | * <code>PS C:\Users\your_login> wsl -l -v |
| | NAME STATE VERSION |
| | Ubuntu_custom Running 2 |
| | * Ubuntu Running 2 |
| | |
| | PS C:\Users\your_login> wsl --unregister Ubuntu |
| | Désinscription... |
| | |
| | PS C:\Users\your_login> wsl -l -v |
| | NAME STATE VERSION |
| | * Ubuntu_custom Running 2</code> |
| | |
| | * The initial installation directory will still be present on ''C:\'', and should probably be left untouched: |
| | * ''C:\Users\your_login\AppData\Local\Packages\CanonicalGroupLimited.UbuntuonWindows_79rhkp1fndgsc\'' |
| | * ...with a very low disk usage (the big ''ext4.vhdx'' is removed during the ''unregister'' step) |
| | |
| | * ''Ubuntu'' will still appear in the Microsoft store, and clicking on ''Launch'' will trigger a re-installation on ''C:\'' |
| | * If you end up with an installation error message and a new //orphan// ''ext4.vhdx'' file on ''C'', click on ''Launch'' to restart and complete the installation |
| | |
| | * ''Ubuntu'' will still appear in the list of installed applications (''Windows'' + ''I'' => ''Applications'') but with a smaller disk usage, probably just the size of the //Linux kernel// installed and updated independently of the Linux installations) |
| |
| === Removing WSL === | === Removing WSL === |
