Skip to content

Commit

Permalink
gh-35637: remark that WSL needs a lot of RAM
Browse files Browse the repository at this point in the history
    
We had reports to this end on sage-develop - typically people are not
able to build scipy with only 2GB of RAM in WSL
(but 5 is enough).
    
URL: #35637
Reported by: Dima Pasechnik
Reviewer(s): Tobias Diez
  • Loading branch information
Release Manager committed May 14, 2023
2 parents f2f5863 + 406e611 commit 9de8c5b
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 2 deletions.
6 changes: 4 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
4 changes: 4 additions & 0 deletions src/doc/en/installation/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -62,6 +62,8 @@ Windows
`official WSL setup guide
<https://docs.microsoft.com/en-us/windows/wsl/install-win10>`_. 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.

Expand All @@ -73,6 +75,8 @@ Windows
`official WSL setup guide
<https://docs.microsoft.com/en-us/windows/wsl/install-win10>`_. 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.

Expand Down

0 comments on commit 9de8c5b

Please sign in to comment.