diff --git a/docs/source/issues.md b/docs/source/issues.md
index 928b12c59f161e6f4ecf912f7b159ad6f12aa616..b5a64307128d42da26876e45cc314566ef5e167f 100644
--- a/docs/source/issues.md
+++ b/docs/source/issues.md
@@ -82,3 +82,9 @@ The following command could potentially solve meta-data issues.
 ```
 gdal_edit.py -stats your_file.tif
 ```
+
+## Conflicting requirements for UMAP
+
+`umap` has `numba` as a dependdencie, which may require `numpy < 2.0` and conflict with other librairies depending on how you installed them. According to `numba` developpers, this
+(should be resolved in comming numba releases)[https://github.com/numba/numba/issues/9708].
+In the mean time, you can use a conda environement or uninstall and reinstall numpy at a previous version.