diff --git a/setup.py b/setup.py
index a2c036dea..3cb397548 100755
--- a/setup.py
+++ b/setup.py
@@ -54,6 +54,7 @@ def read(*filenames, **kwargs):
     "backports.tempfile>=1.0;python_version<'3.4'",
 ]
 docs_require = [
+    "ipykernel<5.0.0",  # doesn't work with jupyter TODO: remove this once there's an upstream fix; https://github.com/jupyter/jupyter/issues/370
     "jupyter>=1.0.0",
     "matplotlib>=2.0.0",
     "nbconvert!=5.4",  # doesn't work with nbsphinx TODO: remove this once there's an upstream fix; https://github.com/jupyter/nbconvert/issues/878