Self-hosted Kubernetes#

The Zero to JupyterHub guide assumes you’re using a managed Kubernetes service with one of the main cloud platforms.

JupyterHub can be deployed on a self-hosted Kubernetes cluster, but this is not officially supported. However you may be able to get help, and find examples of other self-hosted deployments, on the Jupyter community forum.

Kubernetes cluster requirements#

Z2JH assumes your Kubernetes cluster has the following features:

Z2JH assumes you have full administrator access to the cluster.

In many cases you need to consult your Kubernetes provider’s documentation to find out how to enable these features. Please test all these features with a simple deployment before proceeding with the Zero to JupyterHub guide. Z2JH has several interacting components which makes it much more difficult to debug Kubernetes problems, so you will save a lot of time by verifying your cluster is working correctly first.

It is possible to deploy Z2JH without some features, for example by disabling persistent storage or using NodePort, but this is only suitable for testing.