Skip to content

Commit 13a0d2f

Browse files
Add a WSL prerequisites section.
1 parent 3230f00 commit 13a0d2f

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

src/doc/en/installation/source.rst

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -257,9 +257,11 @@ Some additional optional packages are taken care of by:
257257

258258
.. literalinclude:: homebrew-optional.txt
259259

260+
WSL prerequisites
261+
^^^^^^^^^^^^^^^^^
260262

261263
Ubuntu on Windows Subsystem for Linux (WSL) prerequisite installation
262-
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
264+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
263265

264266
Sage can be installed onto Linux running on Windows Subsystem for Linux (WSL). These instructions describe a fresh install of Ubuntu 20.10, but other distributions or installation methods should work too, though have not been tested.
265267

@@ -283,11 +285,17 @@ Sage can be installed onto Linux running on Windows Subsystem for Linux (WSL). T
283285
From this point on, follow the instructions in the :ref:`sec-installation-from-sources-linux-recommended-installation` section.
284286
It is strongly recommended to put the Sage source files in the Linux file system, for example, in the ``/home/username/sage`` directory, and not in the Windows file system (e.g. ``/mnt/c/...``).
285287

288+
WSL permission denied error when building `packaging` package.
289+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
290+
286291
You may encounter permission errors of the kind ``"[Errno 13] Permission denied: 'build/bdist.linux-x86_64/wheel/<package>.dist-info'"`` during ``make``.
287292
This usually comes from a permission conflict between the Windows and Linux file system.
288293
To fix it create a temporary build folder in the Linux file system using ``mkdir -p ~/tmp/sage`` and use it for building by ``eval SAGE_BUILD_DIR="~/tmp/sage" make``.
289294
Also see the `related Github issue <https://github.com/pypa/packaging-problems/issues/258>`_ for other workarounds.
290295

296+
WSL post-installation notes
297+
~~~~~~~~~~~~~~~~~~~~~~~~~~~
298+
291299
When the installation is complete, you may be interested in :ref:`sec-launching-wsl-post-installation`.
292300

293301
.. _section_cygwinprereqs:

0 commit comments

Comments
 (0)