Setting up a simple JupyterHub Server

129 views
Skip to first unread message

Karthik Garimella

unread,
Jul 12, 2017, 3:30:17 PM7/12/17
to Project Jupyter
Hello!

I have created a suite of Jupyter Notebooks for the purpose of teaching some data analysis.  So far, I have dockerized the Jupyter Notebooks to resolve cross-platform dependencies.  In this manner, anyone with Docker installed on their machine can pull the image and run the Jupyter Notebooks.

Now, I would like to use JupyterHub so that an end-user can access these notebooks from a website.  This would be even easier than having to download Docker. However, I am having trouble starting a JupyterHub that is not on localhost.  I'm assuming I need a domain/host. Is there a way to obtain these for free? Could you point me to a simple example of starting a JupyterHub server?

Sorry for the low-level questions; I am completely new to hosting a web server.

Thanks in advance!

Karthik

Jason Stedman

unread,
Jul 12, 2017, 7:52:49 PM7/12/17
to Project Jupyter
Karthik,

We run classes using JupyterHub where I work.

Unfortunately to do this at classroom scale takes significant memory resources. The smallest one can really get away with is 1GB of server ram per user. This means if you have even a small class of 15 students, you really need a 16GB server minimum to host a JupyterHub environment.

This is well beyond the free tier offerings of any cloud provider.

If you are only concerned about sharing the notebooks themselves, I would suggest continuing to have each user run their own Jupyter server using Docker and have the base image include git or wget so the users can download your notebooks from the free hosting options that do exist.

If you do have local or cloud hosted resources(or budget) with sufficient memory available then you are just looking at Docker and network configuration to expose the hub to the local network or internet. You would then need to obtain a certificate for https which is pretty much required, but can be obtained for free from a few good sources.

I hope this helps put things in perspective.

Jason

Matthias Bussonnier

unread,
Jul 13, 2017, 6:24:58 AM7/13/17
to jup...@googlegroups.com
I would suggest reading
http://zero-to-jupyterhub.readthedocs.io/en/latest/ recently announce
on our blog: http://blog.jupyter.org/2017/06/29/introducing-the-helm-chart-for-jupyterhub-deployment-with-kubernetes/

You'll get instruction on how to deploy a hub on google cloud in ~30
minutes. Google cloud offers you $300 free when you sign up which
should easily last you a year. Otherwise why not attempt to use binder
(the beta version is super fast and should stabilize soon:

https://beta.mybinder.org/

--
M
> --
> You received this message because you are subscribed to the Google Groups "Project Jupyter" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to jupyter+u...@googlegroups.com.
> To post to this group, send email to jup...@googlegroups.com.
> To view this discussion on the web visit https://groups.google.com/d/msgid/jupyter/45fdd40f-0b24-4a8d-94ff-03ca60ec27e5%40googlegroups.com.
> For more options, visit https://groups.google.com/d/optout.

Jason Stedman

unread,
Jul 13, 2017, 7:01:07 AM7/13/17
to Project Jupyter
This looks great!

If anyone has luck using this in a classroom environment, it would be great to see actual cost figures.

We end up provisioning at least a gig of ram per classroom user, some of our research users end up using much more. $300 per year would be amazing!

Matthias Bussonnier

unread,
Jul 13, 2017, 7:24:37 AM7/13/17
to jup...@googlegroups.com
I'm going to pull pull a number out of thin air, but IIRC Berkeley deployed something similar and it was $7/student/month without autoscalling. With all the awesome work Yuvi and the Berkeley team did you could likely reduce the cost even more. That will depend a lot of how you set your idle time, culling and usage pattern. 

To unsubscribe from this group and stop receiving emails from it, send an email to jupyter+unsubscribe@googlegroups.com.

To post to this group, send email to jup...@googlegroups.com.

Karthik Garimella

unread,
Jul 13, 2017, 2:04:06 PM7/13/17
to Project Jupyter
Thanks everyone for you input! Beginning to understand what I need to make this project live on JupyterHub... It seems that Google cloud offers a free trial of 365 days.
Reply all
Reply to author
Forward
0 new messages