You need an Azure account to be able to spin your JupyterHub.
β You can get a free account with 150 USD worth of credit following ππΌ this link ππΌ
A simple JupyterHub distribution for a small (1-100) number of users on a single server. You can find more info about it in the official docs ππΌ https://the-littlest-jupyterhub.readthedocs.io/en/latest/index.html
This repository contains the ARM (Azure Resource Manager) template for the Littlest JupyterHub deployment. This template was created to help you deploy a vanilla Littlest JupyterHub by clicking on the deploy to Azure blue button at the top of this document.
The ARM template contains all the basic configuration needed to deploy your own Littlest JupyterHub on Azure.
This template follows the configuration detailed in https://the-littlest-jupyterhub.readthedocs.io/en/latest/install/azure.html. But it reduces some of the friction by eliminating the need to create resources manually using the Azure portal.
π¨ Note that you still need to remove your resources manually when you are done using them.
π§ To deploy your TLJH follow these steps:
- Create an Azure account (if you need a free one go to ππΌ this link ππΌ)
- Click on the
Deploy to Azure
button at the top of the Readme. This will redirect you to the Azure portal login page. - Login to your account.
- Fill in the details in the next screen:
- Subscription: choose the subscription you want to use (e.g. Free Trial)
- Resource group: this will keep all of our resources together. If you have never created a resource group click on
Create new
and give it a meaningful name (e.g. jupyter-resources) - Location: this is the Azure region where you want all your resources to be (e.g. WestEurope, you can check all the available regions here)
- Virtual Machine Name: the name for your virtual machine
- Virtual Machine Size: this will be determined by the workload. You can check the list of available VM sizes here
- Admin UserName: this will be the root user and is needed for the management of your TLJH
- Admin password: choose a secure password for your root user
- OS Disk Type: you have the options Standard HDD (LRS), Standard SSD and Premium SSD (for more details see the docs)
- Data Disk Size: the size of your Data disk size (for more details visit the docs)
By default, the template allows network traffic through HTTP
and https
, do not modify the network and security group rules
.
- Once completed, read the terms and conditions and if you are happy with them tick the
I agree to the terms and conditions stated above
box and click on the Purchase button.
The deployment will take around 10 minutes - first, all your resources will be deployed, and then THLJ will be installed on your VM.
- To check your new Virtual Machine Expand the left-hand panel by clicking on the β>>β button on the top left corner of your dashboard. Find the Virtual Machines tab and click on it.
- Click on your Virtual Machine, copy the Public IP address and access it on the web browser.
π¨ Note this page will be unavailable during installation. If this happens, give it a bit longer and refresh the page.
Once the installation is complete, you will get a login page
- Login using the admin username and password you created before
- Congratulations you have a running working JupyterHub π
π©πΏβπ»β¨ You are now ready to add users, install packages and start using your JupyterHub. For instructions on how to do this visit ππΌ the official documentation
When you deploy a JupyterHub on Azure (either using the Deploy to Azure button or follow the steps from the docs) the following resources are created:
They are all grouped in the same region defined for your Resource group.
Details on how to delete and stop your virtual machine can be found at https://the-littlest-jupyterhub.readthedocs.io/en/latest/howto/providers/azure.html.
If you want to get rid of all the associated resources after you are done with your JupyterHub the easiest way to do it is deleting the resource group altogether (providing you do not have other resources in this group that you might need later).
To delete a resource group:
- Go to "Resource groupsβ on the left-hand panel of your Azure Portal.
- Click on the resource group that contains your JupyterHub resources.
- Click on βDelete resource groupβ you will then be asked to confirm the operation. This operation will take between 5 and 10 minutes.
Here are some links that you might find useful when using the contents in this repo.
- Azure Resource Manger templates docs
- The Littlest JupyterHub docs
- VM available regions
- Azure VM sizes
- Azure VMs disks
Contributions are welcome. Also, if you encounter any issues, please go ahead and create an issue in this repo.
The detailed contribution guidelines can be found ππΌ here