JupyterHub for Teaching

Version: 1.0

Date: Jan 22, 2018

Abstract

This deployment is designed for teaching a small to medium group of trusted users.

As a simple, reusable JupyterHub deployment for your reference, this repository enables installation and deployment of JupyterHub and nbgrader on a single server. The reference deployment follows best practices and has been used by Professor Brian Granger when teaching “Introduction to Data Science”.

Contents

• Design goals
  • Instructors and maintainers
  • Students
• Installation Guide
  • Prerequisites
  • Create the hosts group
  • Secure your deployment
  • Deploy with Ansible
  • Verify your deployment
• Configuring nbgrader
  • Deploy formgrade
  • Configuration notes
  • Troubleshooting: Saving and restoring users
• Using nbgrader
  • Preparing class assignments - Instructor
  • Working with an assignment - Students
  • Grading the assignments - Instructor
  • Next steps
• Checklist for a JupyterHub teaching deployment
  • Notes
  • 1. Prepare the server
  • 2. Install JupyterHub source
  • 3. Secure before deployment
  • 4. Create JupyterHub hosts group
  • 5. Configure admins
  • 6. Configure users
  • 7. Add optional services
  • 8. Deploy with Ansible
  • 9. Verify deployment and reload supervisor
  • 10. JupyterLab
• Acknowledgment
• Repository Contents
  • Ansible application
  • Inventory (Ansible)
  • Playbooks (Ansible)
  • Variables (Ansible)
  • Roles (Ansible)
  • Development
  • Documentation