CEMAC FORK OF MIKE CROUCHERS JUPYERHUB ON AZURE

🚧 MAJOR OVERHAUL OF DOCUMENTATION IN PROGRESS

This repository contains scripts for automatic creation of customised JupyterHub instances running on Azure cloud designed for multi-user classes.

- NB: This is designed to work following Leeds Uni Practice
- Central IT control the Azure account and must set up VM (Jan 2019)

Version 2.0

Following on from Mike Croucher's jupyterhub_on_azure setup, Version builds on documentation and functionality.

Features

• Set up JupyterHub on Azure Ubuntu LTS machine
• Server settings
• Anaconda Installation
• Jupyter hub configuration
• Certificate generation
• Legacy VM creation scripts

Requirements

• Azure VM, IP address and Admin ID to access (via IT following create_vm)
• UBUNTU 18.04 LTS (recommended)

Installation/ Usage (recommended method)

• ssh to Azure machine ssh -Y <adim_ID>@<VM_IP>
• git clone https://github.com/cemac/jupyterhub_on_azure.git
• Follow ubuntu_setup to set up server and users
• Follow python_setup to set up python environment
• Follow jupyterhub_setup to set up Jupyter Hub

NB previously this set up was done using mike's create_vm scripts, however this is now managed by Leeds central IT - the scripts are preserved for reference in create_vm

Tips

COLLABORATING

Collaboration is very welcome and encouraged.

• A full guide on submitting issue and bug are given in our contribution guidelines
• Please use our issue templates for feature requests and bug fixes.

---

FUTURE

This project will move to a containerised set up in the future in a new JupyterHubLeeds project for academic year 2019/2020.

---

ACKNOWLEGEMENTS

Thanks to Mike Croucher for Setting this up.

LICENSE

This project is currently licensed under the MIT license.