From dfecab1caf6f38b18dd27bc1e1d8c38787764bf2 Mon Sep 17 00:00:00 2001 From: Bo Anderson Date: Fri, 14 Oct 2022 19:17:47 +0100 Subject: [PATCH] docs: discontinue WSL 1 support; recommend WSL 2 --- docs/Homebrew-on-Linux.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/Homebrew-on-Linux.md b/docs/Homebrew-on-Linux.md index f3a3e3f31b..cc18fb166b 100644 --- a/docs/Homebrew-on-Linux.md +++ b/docs/Homebrew-on-Linux.md @@ -9,7 +9,7 @@ redirect_from: # Homebrew on Linux -The Homebrew package manager may be used on Linux and [Windows Subsystem for Linux (WSL)](https://docs.microsoft.com/en-us/windows/wsl/about). Homebrew was formerly referred to as Linuxbrew when running on Linux or WSL. It can be installed in your home directory, in which case it does not use *sudo*. Homebrew does not use any libraries provided by your host system, except *glibc* and *gcc* if they are new enough. Homebrew can install its own current versions of *glibc* and *gcc* for older distributions of Linux. +The Homebrew package manager may be used on Linux and [Windows Subsystem for Linux (WSL)](https://docs.microsoft.com/en-us/windows/wsl/about) 2. Homebrew was formerly referred to as Linuxbrew when running on Linux or WSL. It can be installed in your home directory, in which case it does not use *sudo*. Homebrew does not use any libraries provided by your host system, except *glibc* and *gcc* if they are new enough. Homebrew can install its own current versions of *glibc* and *gcc* for older distributions of Linux. [Features](#features), [installation instructions](#install) and [requirements](#requirements) are described below. Terminology (e.g. the difference between a Cellar, Tap, Cask and so forth) is [explained in the documentation](Formula-Cookbook.md#homebrew-terminology). @@ -78,6 +78,10 @@ You may need to install your own Ruby using your system package manager, a PPA, Homebrew does not currently support 32-bit x86 platforms. It would be possible for Homebrew to work on 32-bit x86 platforms with some effort. An interested and dedicated person could maintain a fork of Homebrew to develop support for 32-bit x86. +### Windows Subsystem for Linux (WSL) 1 + +Due to [known issues](https://github.com/microsoft/WSL/issues/8219) with WSL 1, you may experience issues running various executables installed by Homebrew. We recommend you switch to WSL 2 instead. + ## Homebrew on Linux Community - [@HomebrewOnLinux on Twitter](https://twitter.com/HomebrewOnLinux)