Skip to content

jupyterhub/zero-to-jupyterhub-k8s

Repository files navigation

Zero to JupyterHub with Kubernetes

Documentation build status GitHub Workflow Status - Test GitHub Workflow Status - Vuln. scan Latest stable release of the Helm chart Latest pre-release of the Helm chart Latest development release of the Helm chart
GitHub Discourse Gitter Contribute

This repo contains a Helm chart for JupyterHub and a guide to use it. Together they allow you to make a JupyterHub available to a very large group of users such as the staff and students of a university.

The guide

The Zero to JupyterHub with Kubernetes guide provides user-friendly steps to deploy JupyterHub on a cloud using Kubernetes and Helm.

The guide is complemented well by the documentation for JupyterHub.

The Helm chart

The JupyterHub Helm chart lets a user create a reproducible and maintainable deployment of JupyterHub on a Kubernetes cluster in a cloud environment. The released charts are made available in our Helm chart repository.

Notice of Participation in Study

Please note that this repository is participating in a study into sustainability of open source projects. Data will be gathered about this repository for approximately the next 12 months, starting from 2021-06-11.

Data collected will include number of contributors, number of PRs, time taken to close/merge these PRs, and issues closed.

For more information, please visit the informational page or download the participant information sheet.

History

Much of the initial groundwork for this documentation is information learned from the successful use of JupyterHub and Kubernetes at UC Berkeley in their Data 8 program.

Acknowledgements

Thank you to the following contributors:

  • Aaron Culich
  • Carol Willing
  • Chris Holdgraf
  • Erik Sundell
  • Ryan Lovett
  • Yuvi Panda
  • Laurent Goderre

Future contributors are encouraged to add themselves to this README file too.

Licensing

This repository is dual licensed under the Apache2 (to match the upstream Kubernetes charts repository) and 3-clause BSD (to match the rest of Project Jupyter repositories) licenses. See the LICENSE file for more information!