diff --git a/docs/conda_env.yml b/docs/conda_env.yml
new file mode 100644
index 000000000..d10495b71
--- /dev/null
+++ b/docs/conda_env.yml
@@ -0,0 +1,9 @@
+name: notebook_docs
+dependencies:
+- sphinx>=1.3
+- sphinx_rtd_theme
+- jinja2
+- tornado
+- nbformat
+- jupyter_client
+- ipykernel
diff --git a/docs/requirements.txt b/docs/requirements.txt
deleted file mode 100644
index 32ca6a6de..000000000
--- a/docs/requirements.txt
+++ /dev/null
@@ -1,11 +0,0 @@
-jupyter
-sphinx_rtd_theme
-jinja2
-tornado
--e git+https://github.com/ipython/ipython_genutils.git#egg=ipython_genutils
--e git+https://github.com/ipython/traitlets.git#egg=traitlets
--e git+https://github.com/jupyter/jupyter_core.git#egg=jupyter_core
--e git+https://github.com/jupyter/nbformat.git#egg=nbformat
--e git+https://github.com/jupyter/jupyter_client.git#egg=jupyter_client
--e git+https://github.com/ipython/ipython.git#egg=ipython
--e git+https://github.com/ipython/ipykernel.git#egg=ipykernel
diff --git a/readthedocs.yml b/readthedocs.yml
new file mode 100644
index 000000000..d7245f77f
--- /dev/null
+++ b/readthedocs.yml
@@ -0,0 +1,5 @@
+conda:
+    file: docs/conda_env.yml
+python:
+    version: 3
+    setup_py_install: true