diff --git a/mkdocs/docs/HPC/FAQ.md b/mkdocs/docs/HPC/FAQ.md index 4e9ac13b033..d649e2ef91d 100644 --- a/mkdocs/docs/HPC/FAQ.md +++ b/mkdocs/docs/HPC/FAQ.md @@ -325,6 +325,18 @@ Note that it is still preferred to submit a software installation request, as the software installed by the HPC team will be optimized for the HPC environment. This can lead to dramatic performance improvements. +!!! warning + Do not use `pip install --user` to install software, as this places packages + in `~/.local/lib/python*/site-packages`, potentially causing conflicts with software installed by the HPC team. + + Also, avoid using `pip install --prefix` or `pip install --target` with `$PYTHONPATH`, + since `$PYTHONPATH` is a global setting that affects all Python versions. + When `$PYTHONPATH` includes directories with packages from different Python versions, it can lead to conflicts. + + Instead, use a Python virtual environment for package installations in your home directory. + For guidance on setting up virtual environments, + refer to the [Python virtual environments setup guide](./setting_up_python_virtual_environments.md). + ### Is my connection compromised? Remote host identification has changed On Monday 25 April 2022, the login nodes received an update to RHEL8.