-
Notifications
You must be signed in to change notification settings - Fork 597
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge remote-tracking branch 'origin/live'
- Loading branch information
Showing
17 changed files
with
1,699 additions
and
1,690 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,10 +1,10 @@ | ||
|
|
||
| # [About the Windows Subsystem for Linux](./about.md) | ||
| # [Install on Windows 10](./install_guide.md) | ||
| # [Install on Windows 10](./install-win10.md) | ||
| # [Install on Windows Server](./install-on-server.md) | ||
| # [User account and permissions](./user_support.md) | ||
| # [User account and permissions](./user-support.md) | ||
| # [Multi-distro management](./wsl-config.md) | ||
| # [Interoperability](./interop.md) | ||
| # [Frequently Asked Questions](./faq.md) | ||
| # [Troubleshooting](./troubleshooting.md) | ||
| # [Release Notes](./release_notes.md) | ||
| # [Release Notes](./release-notes.md) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,3 +1,3 @@ | ||
| --- | ||
| redirect_url: https://msdn.microsoft.com/commandline/wsl/about | ||
| --- | ||
| redirect_url: about | ||
| --- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,88 @@ | ||
| --- | ||
| title: Install the Linux Subsystem on Windows 10 | ||
| description: Installation instructions for the Linux Subsystem on Windows 10. | ||
| keywords: BashOnWindows, bash, wsl, windows, windows subsystem for linux, windowssubsystem, ubuntu, windows 10 | ||
| author: scooley | ||
| ms.author: scooley | ||
| ms.date: 7/11/2017 | ||
| ms.topic: article | ||
| ms.prod: windows-subsystem-for-linux | ||
| ms.service: windows-subsystem-for-linux | ||
| ms.assetid: 7afaeacf-435a-4e58-bff0-a9f0d75b8a51 | ||
| --- | ||
|
|
||
| # Windows 10 Installation Guide | ||
|
|
||
| ## Install the Windows Subsystem for Linux | ||
| Enable the "Windows Subsystem for Linux" optional feature and reboot. | ||
|
|
||
| 1. Open PowerShell as Administrator and run: | ||
| ``` PowerShell | ||
| Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux | ||
| ``` | ||
| 2. Restart your computer when prompted. | ||
| ## Fall Creators Update and later: Install from the Windows Store | ||
| > This section is for Windows Insiders (build 16215 or later). Follow these steps to [Check your build](troubleshooting.md#check-your-build-number). For earlier versions of Windows 10, follow [these instructions using lxrun](install-win10.md#for-anniversary-update-and-creators-update-install-using-lxrun). | ||
| 1. Open the Windows Store and choose your favorite Linux distribution. | ||
| Here are links directly to the store installers: | ||
| * [Ubuntu](https://www.microsoft.com/store/p/ubuntu/9nblggh4msv6) | ||
| * [OpenSUSE](https://www.microsoft.com/store/apps/9njvjts82tjx) | ||
| * [SLES](https://www.microsoft.com/store/apps/9p32mwbh6cns) | ||
|  | ||
| 2. Select "Get" | ||
| > **Troubleshooting: Installation failed with error 0x80070003** | ||
| > The Windows Subsystem for Linux only runs on your system drive (usually this is your C: drive). Make sure that new apps are stored on your system drive. | ||
| > Open **Settings** -> **Storage** -> **More Storage Settings: Change where new content is saved** | ||
| >  | ||
| 3. Once the download has completed, select "Launch". | ||
| This will open a console window. Wait for installation to complete then you will be prompted to create your UNIX user account. | ||
|  | ||
| > **Troubleshooting: Installation failed with error 0x8007007e** | ||
| > This error occurs when your system doesn't support Linux from the store. Make sure that: | ||
| > * You're running Windows build 16215 or later. [Check your build](troubleshooting.md#check-your-build-number). | ||
| > * The Windows Subsystem for Linux optional component is enabled and the computer has restarted. [Make sure WSL is enabled](troubleshooting.md#confirm-wsl-is-enabled). | ||
| 5. Create your UNIX username and password. This user account can be different from, and has no relationship to, your Windows username and password. [Read more](user-support.md). | ||
| You're done! Now you can use your Linux environment. | ||
| ## For Anniversary Update and Creators Update: Install using lxrun | ||
| lxrun installs Ubuntu user-mode by default on top of the Windows subsystem for Linux. | ||
| > Since moving to the store, we have stopped keeping this user-mode image up to date. When you're done, run `apt-get update`. | ||
| 1. Turn on Developer Mode | ||
| Open **Settings** -> **Update and Security** -> **For developers** | ||
| Select the Developer Mode radio button | ||
|  | ||
| 2. Open a command prompt. Run `bash` | ||
|  | ||
| After you have accepted the License, the Ubuntu user-mode image will be downloaded and extracted. A "Bash on Ubuntu on Windows" shortcut will be added to your start menu. | ||
| 3. Launch a new Ubuntu shell by either: | ||
| * Running `bash` from a command-prompt | ||
| * Clicking the start menu shortcut | ||
| 4. Create a UNIX user | ||
| The first time you install the Windows subsystem for Linux, you will be prompted to create a UNIX username and password. | ||
|  | ||
| This UNIX username and password can be different from, and has no relationship to, your Windows username and password. [Learn more about your UNIX account.](user-support.md). | ||
| After installation your Linux distribution will be located at: `%localappdata%\lxss\`. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,100 +1,3 @@ | ||
| --- | ||
| title: Install the Linux Subsystem on Windows 10 | ||
| description: Installation instructions for the Linux Subsystem on Windows 10. | ||
| keywords: BashOnWindows, bash, wsl, windows, windows subsystem for linux, windowssubsystem, ubuntu, windows 10 | ||
| author: scooley | ||
| ms.date: 7/11/2017 | ||
| ms.topic: article | ||
| ms.prod: windows-subsystem-for-linux | ||
| ms.service: windows-subsystem-for-linux | ||
| ms.assetid: 7afaeacf-435a-4e58-bff0-a9f0d75b8a51 | ||
| redirect_url: install-win10 | ||
| --- | ||
|
|
||
| # Windows 10 Installation Guide | ||
|
|
||
| ## Prerequisites | ||
| Your PC must be running a 64-bit version of Windows 10 Anniversary Update or later (build 1607+). | ||
|
|
||
| To find your PC's architecture and Windows build number, open | ||
| **Settings** > **System** > **About** | ||
|
|
||
| Look for the **OS Build** and **System Type** fields. | ||
|  | ||
|
|
||
| ## Install the Windows Subsystem for Linux | ||
| Enable the "Windows Subsystem for Linux" optional feature and reboot. | ||
|
|
||
| 1. Open PowerShell as Administrator and run: | ||
| ``` PowerShell | ||
| Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux | ||
| ``` | ||
| 2. Restart your computer when prompted. | ||
| ## Fall Creators Update and later: Install from the Windows Store | ||
| > This section is for Windows Insiders (build 16215 or later). Follow these steps to [Check your build](install_guide.md#prerequisites). For earlier versions of Windows 10, follow [these instructions using lxrun](install_guide.md#for-anniversary-update-and-creators-update-install-using-lxrun). | ||
| 1. Open the Windows Store and choose your favorite Linux distribution. | ||
| Here are links directly to the store installers: | ||
| * [Ubuntu](https://www.microsoft.com/store/p/ubuntu/9nblggh4msv6) | ||
| * [OpenSUSE](https://www.microsoft.com/store/apps/9njvjts82tjx) | ||
| * [SLES](https://www.microsoft.com/store/apps/9p32mwbh6cns) | ||
|  | ||
| 2. Select "Get" | ||
| > **Troubleshooting: Installation failed with error 0x80070003** | ||
| > The Windows Subsystem for Linux only runs on your system drive (usually this is your C: drive). Make sure that new apps are stored on your system drive. | ||
| > Open **Settings** -> **Storage** -> **More Storage Settings: Change where new content is saved** | ||
| >  | ||
| 3. Once the download has completed, select "Launch". | ||
| This will open a console window. Wait for installation to complete then you will be prompted to create your UNIX user account. | ||
|  | ||
| > **Troubleshooting: Installation failed with error 0x8007007e** | ||
| > This error occurs when your system doesn't support Linux from the store. Make sure that: | ||
| > * You're running Windows build 16215 or later. [Check your build](install_guide.md#prerequisites). | ||
| > * The Windows Subsystem for Linux optional component is enabled. [Instructions here](install_guide.md#Install-the-Windows-Subsystem-for-Linux). | ||
| 5. Create your UNIX username and password. This user account can be different from, and has no relationship to, your Windows username and password. [Read more](https://msdn.microsoft.com/en-us/commandline/wsl/user_support). | ||
| You're done! Now you can use your Linux environment. | ||
| ## For Anniversary Update and Creators Update: Install using lxrun | ||
| lxrun installs Ubuntu user-mode by default on top of the Windows subsystem for Linux. | ||
| > Since moving to the store, we have stopped keeping this user-mode image up to date. When you're done, run apt-get update. | ||
| 1. Turn on Developer Mode | ||
| Open **Settings** -> **Update and Security** -> **For developers** | ||
| Select the Developer Mode radio button | ||
|  | ||
| 2. Open a command prompt. Run `bash` | ||
|  | ||
| After you have accepted the License, the Ubuntu user-mode image will be downloaded and extracted. A "Bash on Ubuntu on Windows" shortcut will be added to your start menu. | ||
| 3. Launch a new Ubuntu shell by either: | ||
| * Running `bash` from a command-prompt | ||
| * Clicking the start menu shortcut | ||
| 4. Create a UNIX user | ||
| The first time you install the Windows subsystem for Linux, you will be prompted to create a UNIX username and password. | ||
|  | ||
| This UNIX username and password can be different from, and has no relationship to, your Windows username and password. [Learn more about your UNIX account.](https://msdn.microsoft.com/en-us/commandline/wsl/user_support). | ||
| After installation your Linux distribution will be located at: `%localappdata%\lxss\`. | ||
| **Avoid creating and/or modifying files in %localappdata%\lxss\ using Windows tools and apps!** If you do, it is likely that your Linux files will be corrupted and data loss may occur. Avoid this issue by using a directory located under /mnt/. | ||
| Read this [blog post](https://blogs.msdn.microsoft.com/commandline/2016/11/17/do-not-change-linux-files-using-windows-apps-and-tools/) for more information. | ||
| You're done! Go use your new Linux environment! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.