mirror of https://github.com/jupyterhub/the-littlest-jupyterhub.git synced 2025-12-18 21:54:05 +08:00

Files

Min RK 76dadd7ef9 fix absolute refs

myst seems to create different refs than sphinx

2023-03-27 10:16:51 +02:00

4.3 KiB

Raw Blame History

(install-ovh)=

Installing on OVH

Goal

By the end of this tutorial, you should have a JupyterHub with some admin users and a user environment with packages you want installed running on OVH.

Pre-requisites

An OVH account.

Step 1: Installing The Littlest JupyterHub

Let's create the server on which we can run JupyterHub.

Log in to the OVH Control Panel.
Click the Public Cloud button in the navigation bar.
```
:alt: Public Cloud entry in the navigation bar
```
If you don't have an OVH Stack, you can create one by clicking on the following button:
```
:alt: Button to create an OVH stack
```
Select a name for the project:
```
:alt: Select a name for the project
```
If you don't have a payment method yet, select one and click on "Create my project":
```
:alt: Select a payment method
```
Using the Public Cloud interface, click on Create an instance:
```
:alt: Create a new instance
```
Select a model for the instance. A good start is the S1-4 model under Shared resources which comes with 4GB RAM, 1 vCores and 20GB SSD.
Select a region.
Select Ubuntu 22.04 as the image:
```
:alt: Select Ubuntu 22.04 as the image
```
OVH requires setting an SSH key to be able to connect to the instance. You can create a new SSH by following these instructions. Be sure to copy the content of the ~/.ssh/id_rsa.pub file, which corresponds to the public part of the SSH key.
Select Configure your instance, and select a name for the instance. Under Post-installation script, copy the text below and paste it in the text box. Replace <admin-user-name> with the name of the first admin user for this JupyterHub. This admin user can log in after the JupyterHub is set up, and can configure it to their needs. Remember to add your username!
```
#!/bin/bash
curl -L https://tljh.jupyter.org/bootstrap.py \
  | sudo python3 - \
    --admin <admin-user-name>
```
:::{note} See if you want to understand exactly what the installer is doing. documents other options that can be passed to the installer. :::
```
:alt: Add post-installation script
```
Select a billing period: monthly or hourly.
Click the Create an instance button! You will be taken to a different screen, where you can see progress of your server being created.
```
:alt: Select suitable hostname for your server
```
In a few seconds your server will be created, and you can see the public IP used to access it.
```
:alt: Server finished creating, public IP available
```
The Littlest JupyterHub is now installing in the background on your new server. It takes around 5-10 minutes for this installation to complete.
Check if the installation is complete by copying the public ip of your server, and trying to access it with a browser. This will fail until the installation is complete, so be patient.
When the installation is complete, it should give you a JupyterHub login page.
```
:alt: JupyterHub log-in page
```
Login using the admin user name you used in step 6, and a password. Use a strong password & note it down somewhere, since this will be the password for the admin user account from now on.
Congratulations, you have a running working JupyterHub!

Step 2: Adding more users

.. include:: add_users.txt

Step 3: Install conda / pip packages for all users

.. include:: add_packages.txt

4.3 KiB Raw Blame History