Next

BinderHub

Note

BinderHub is under active development and subject to breaking changes.

Getting started

The primary goal of BinderHub is creating custom computing environments that can be used by many remote users. BinderHub enables an end user to easily specify a desired computing environment from a GitHub repo. BinderHub then serves the custom computing environment at a URL which users can access remotely.

This guide assists you, an administrator, through the process of setting up your BinderHub deployment.

To get started creating your own BinderHub, start with Create your cloud resources.

Note

BinderHub uses a JupyterHub running on Kubernetes for much of its functionality. For information on setting up and customizing your JupyterHub, we recommend reading the Zero to JupyterHub Guide.

BinderHub Deployments

Our directory of BinderHubs is published at BinderHub Deployments.

If your BinderHub deployment is not listed, please open an issue to discuss adding it.

Zero to BinderHub

A guide to help you create your own BinderHub from scratch.

Zero to BinderHub

• 1. Create your cloud resources
  • 1.1. Setting up Kubernetes on Google Cloud
  • 1.2. Install Helm
• 2. Set up the container registry
  • 2.1. Set up Google Container Registry
  • 2.2. Set up Docker Hub registry
  • 2.3. Next step
• 3. Set up BinderHub
  • 3.1. Preparing to install
  • 3.2. Create secret.yaml file
  • 3.3. Create config.yaml
  • 3.4. Install BinderHub
  • 3.5. Connect BinderHub and JupyterHub
  • 3.6. Try out your BinderHub Deployment
  • 3.7. Increase your GitHub API limit
• 4. Tear down your Binder deployment
  • 4.1. Contracting the size of your cluster
  • 4.2. Deleting the cluster

Customization and deployment information

Information on how to customize your BinderHub as well as explore what others in the community have done.

Customization and deployment

• Debugging BinderHub
  • Changing the helm chart
• Customizing your BinderHub deployment
• BinderHub Deployments
  • GESIS - Leibniz-Institute for the Social Sciences
  • Pangeo - A community platform for big data geoscience

BinderHub Developer and Architecture Documentation

A more detailed overview of the BinderHub design, architecture, and functionality.

Developer and architecture docs

• The BinderHub Architecture
  • Tools used by BinderHub
  • What happens when a user clicks a Binder link?
  • A diagram of the BinderHub architecture
• Event Logging
  • Events vs Metrics
  • What events to emit?
• BinderHub API Documentation
  • Endpoint
  • Provider
  • Events
  • Heartbeat
• Configuration and Source Code Reference
  • app
  • build
  • builder
  • main
  • registry
  • repoproviders

1. Create your cloud resources