From 49fc47e2bbb802b45a37183f45418197816aef37 Mon Sep 17 00:00:00 2001 From: Carol Willing Date: Fri, 26 Aug 2016 05:02:33 -0700 Subject: [PATCH] Backport PR #1713: Add note on JupyterHub to docs Checked that it looks fine once built, wasn't sure if it was an appropriate use of an important block. addresses 1712 Signed-off-by: Min RK --- docs/source/public_server.rst | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/source/public_server.rst b/docs/source/public_server.rst index d65ba27b3..c8f043873 100644 --- a/docs/source/public_server.rst +++ b/docs/source/public_server.rst @@ -16,12 +16,21 @@ serving HTTP requests. This document describes how you can :ref:`secure a notebook server ` and how to -:ref:`run it on a public interface `. +:ref:`run it on a public interface `. + +.. important:: + + **This is not the multi-user server you are looking for**. This document describes how you can run a public server with a single user. This should only be done by someone who wants remote access to their personal machine. Even so, doing this requires a thorough understanding of the set-ups limitations and security implications. If you allow multiple users to access a notebook server as it is described in this document, their commands may collide, clobber and overwrite each other. + + If you want a multi-user server, the official solution is JupyterHub_. To use JupyterHub, you need a Unix server (typically Linux) running somewhere that is accessible to your users on a network. This may run over the public internet, but doing so introduces additional of `security concerns `_. + + .. _ZeroMQ: http://zeromq.org .. _Tornado: http://www.tornadoweb.org +.. _JupyterHub: https://jupyterhub.readthedocs.io/en/latest/ .. _notebook_server_security: