From cba8fa787131f33f5021f8e72e92e90e293ad414 Mon Sep 17 00:00:00 2001 From: Dima Pasechnik Date: Fri, 12 May 2023 14:42:10 +0100 Subject: [PATCH 1/2] remark that WSL needs a lot of RAM We had reports to this end on sage-develop --- src/doc/en/installation/index.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/doc/en/installation/index.rst b/src/doc/en/installation/index.rst index b8ad5522062..3d25f8ffbb7 100644 --- a/src/doc/en/installation/index.rst +++ b/src/doc/en/installation/index.rst @@ -62,6 +62,8 @@ Windows `official WSL setup guide `_. Be sure to do the steps to install WSL2 and set it as default. + Make sure to allocate enough RAM to WSL: 5GB is known to be enough, + 2GB might not allow you to build some packages. Then go to the Microsoft Store and install Ubuntu (or another Linux distribution). Start Ubuntu from the start menu. @@ -73,6 +75,8 @@ Windows `official WSL setup guide `_. Be sure to do the steps to install WSL2 and set it as default. + Make sure to allocate enough RAM to WSL: 5GB is known to be enough, + 2GB might not allow you to build some packages. Then go to the Microsoft Store and install Ubuntu (or another Linux distribution). Start Ubuntu from the start menu. From 406e6116348b190913f40bf182bb69eb8bdcc4a4 Mon Sep 17 00:00:00 2001 From: Dima Pasechnik Date: Fri, 12 May 2023 18:18:00 +0100 Subject: [PATCH 2/2] RAM for WSL in README.md --- README.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e5a7f2b0bd6..f086349a015 100644 --- a/README.md +++ b/README.md @@ -58,9 +58,11 @@ mailing list](https://groups.google.com/group/sage-devel). -------------------------------- The preferred way to run Sage on Windows is using the [Windows Subsystem for -Linux](https://docs.microsoft.com/en-us/windows/wsl/faq), which allows +Linux](https://docs.microsoft.com/en-us/windows/wsl/faq), a.k.a. WSL, which allows you to install a standard Linux distribution such as Ubuntu within -your Windows. Then all instructions for installation in Linux apply. +your Windows. Make sure you allocate WSL sufficient RAM; 5GB is known to work, while +2GB might be not enough for building Sage from source. +Then all instructions for installation in Linux apply. As an alternative, you can also run Linux on Windows using Docker (see above) or other virtualization solutions.