diff --git a/docs/source/user_guide/troubleshooting.rst b/docs/source/user_guide/troubleshooting.rst index ac443c6bd2..b26949c982 100644 --- a/docs/source/user_guide/troubleshooting.rst +++ b/docs/source/user_guide/troubleshooting.rst @@ -134,3 +134,13 @@ When using Mamba/Micromamba inside a QEMU guest, installing packages may sometim mamba install ... See `#1611 `_ for discussion. + + +Hangs during package installation on NFS (Network File Systems) +--------------------------------------------------------------- +When using Mamba/Micromamba in a environment with NFS, package installation (e.g., NumPy) may hang at the step when ``libmamba`` attempts to lock a directory. +A solution is to update the Mamba/Micromamba configuration to not use lockfile by the command:: + + micromamba config set use_lockfiles False + +See `#2592 `_, `#1446 `_, `#1448 `_, `#1515 `_ for more details.