diff --git a/docs/develop.md b/docs/develop.md
index b9cf979e60df9f8996b50d8ee846479c7372dd0f..d7f5ba63d64f44c6216b607416fda4872bb5ba9e 100644
--- a/docs/develop.md
+++ b/docs/develop.md
@@ -22,16 +22,16 @@ https://guides.github.com/activities/forking/
 
 ## Install Dependencies
 
-- Using `pipenv`
-  https://pipenv.kennethreitz.org/en/latest/
+- Using `poetry`
+  https://github.com/python-poetry/poetry
 
   > `pyenv` is also useful for installing specific/multiple versions of python
   >
   > - https://github.com/pyenv/pyenv
   > - https://github.com/pyenv-win/pyenv-win
 
-      pipenv install --dev
-      pipenv shell
+      poetry install
+      poetry shell
 
 - Or, using Miniconda/Anaconda
   https://conda.io/miniconda.html
diff --git a/docs/metadata_webservice.md b/docs/metadata_webservice.md
index 777d9656456ffce7967a1b045ef3efc686743df0..f723c0c9b411e05240d0657bcbb4240f0aa0b156 100644
--- a/docs/metadata_webservice.md
+++ b/docs/metadata_webservice.md
@@ -27,13 +27,13 @@ exit
 ```
 
 ```
-pipenv run alembic upgrade head
+poetry run alembic upgrade head
 ```
 
 ### Add some testing data (depends on DATABASE_URL environment set above).
 
 ```
-pipenv run python test_metadata.py
+poetry run python test_metadata.py
 ```
 
 ## Set up OpenID application in code.usgs.gov.
@@ -68,5 +68,5 @@ export SECRET_SALT=salt
 - Run app
 
 ```
-pipenv run uvicorn geomagio.api:app
+poetry run uvicorn geomagio.api:app
 ```