From c128d1bdf664857861756b38ca3fad0ae570efb3 2014-11-18 13:56:29 From: Reggie Pierce Date: 2014-11-18 13:56:29 Subject: [PATCH] Public server firewall configuration Added section on firewall configuration. This should prevent users (like me) from struggling to figure out why their servers aren't executing code. --- diff --git a/docs/source/notebook/public_server.rst b/docs/source/notebook/public_server.rst index f79d179..9e197ef 100644 --- a/docs/source/notebook/public_server.rst +++ b/docs/source/notebook/public_server.rst @@ -107,6 +107,18 @@ You can then start the notebook and access it later by pointing your browser to ``https://your.host.com:9999`` with ``ipython notebook --profile=nbserver``. + +Firewall Setup +`````````````` + +To function correctly, the firewall on computer running the ipython server must be +configured to allow connections from client machines on the ``c.NotebookApp.port`` +port to allow connections to the web interface. The firewall must also allow +connections from 127.0.0.1 on ports in the range of 10000 to 65535, which are used +by the server to communicate with the notebook kernels. The kernel communication +ports are chosen randomly by ZeroMQ, and my require multiple connections per kernel +so a large range of ports must be accessible. + Running with a different URL prefix -----------------------------------