diff --git a/api/README.md b/api/README.md
index a46af83ce..f25a18b48 100644
--- a/api/README.md
+++ b/api/README.md
@@ -12,7 +12,6 @@ You will need an environment file. See: `.env.example`. Contact current maintain
   - then activate the virtual environment with `poetry shell`
   - then run:
     - python -m pip install gdal==$(gdal-config --version)
-    - pip install greenlet
   - Follow [vsc setup steps](../setup/VSC.md)
 - Manual (linux): See [manual setup](../docs/MANUAL_SETUP.md).
   Note: you may want to alias `python3` as `python` in your profile
@@ -43,3 +42,20 @@ Or run continuously with pytest-testmon and pytest-watch (`ptw --runner "pytest
 ```bash
 make test-watch
 ```
+
+### Troubleshooting
+
+**Poetry can't install rpy2**
+Error: `ld: library not found for -lpcre2-8`
+
+pcre2 should be installed after running [mac.sh](../setup/mac.sh). This can be verified by running
+
+```bash
+brew list pcre2
+```
+
+This issue can be resolved by running the following command before `poetry_setup.sh`: (adjust path as necessary)
+
+```bash
+export LIBRARY_PATH="/opt/homebrew/Cellar/pcre2/10.42/lib/:$LIBRARY_PATH"
+```
diff --git a/api/poetry.lock b/api/poetry.lock
index 948e49b68..dcb21f84d 100644
--- a/api/poetry.lock
+++ b/api/poetry.lock
@@ -1,4 +1,4 @@
-# This file is automatically @generated by Poetry 1.5.1 and should not be changed by hand.
+# This file is automatically @generated by Poetry 1.6.1 and should not be changed by hand.
 
 [[package]]
 name = "affine"
@@ -4603,7 +4603,7 @@ files = [
 ]
 
 [package.dependencies]
-greenlet = {version = "!=0.4.17", markers = "platform_machine == \"win32\" or platform_machine == \"WIN32\" or platform_machine == \"AMD64\" or platform_machine == \"amd64\" or platform_machine == \"x86_64\" or platform_machine == \"ppc64le\" or platform_machine == \"aarch64\""}
+greenlet = {version = "!=0.4.17", markers = "platform_machine == \"aarch64\" or platform_machine == \"ppc64le\" or platform_machine == \"x86_64\" or platform_machine == \"amd64\" or platform_machine == \"AMD64\" or platform_machine == \"win32\" or platform_machine == \"WIN32\""}
 typing-extensions = ">=4.2.0"
 
 [package.extras]
@@ -5126,4 +5126,4 @@ multidict = ">=4.0"
 [metadata]
 lock-version = "2.0"
 python-versions = ">=3.10.4,<3.11"
-content-hash = "4ecd56c5e78f1f9b92f963d9788854f7247183e2922b51b07e2a0bcac6ee6410"
+content-hash = "68d09c22907b4b147fd546b6ed8371f03c9eb2e8769bc87a88d4899b58f577fa"
diff --git a/api/pyproject.toml b/api/pyproject.toml
index 4ac5e1794..1af15c9ab 100644
--- a/api/pyproject.toml
+++ b/api/pyproject.toml
@@ -42,6 +42,7 @@ rasterio = "^1.3.2"
 scikit-learn = "^1.1.3"
 httpx = "^0.24.0"
 orjson = "^3.9.0"
+greenlet = "^2.0.2"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^7.2.1"