mirror of
https://github.com/jupyterhub/jupyterhub.git
synced 2025-10-07 18:14:10 +00:00
79 lines
2.2 KiB
Markdown
79 lines
2.2 KiB
Markdown
# Quickstart
|
|
|
|
## Prerequisites
|
|
|
|
Before installing JupyterHub, you will need:
|
|
|
|
- a Linux/Unix based system
|
|
- [Python](https://www.python.org/downloads/) 3.4 or greater. An understanding
|
|
of using [`pip`](https://pip.pypa.io/en/stable/) or
|
|
[`conda`](https://conda.io/docs/get-started.html) for
|
|
installing Python packages is helpful.
|
|
- [nodejs/npm](https://www.npmjs.com/). [Install nodejs/npm](https://docs.npmjs.com/getting-started/installing-node),
|
|
using your operating system's package manager. For example, install on Linux
|
|
Debian/Ubuntu using:
|
|
|
|
```bash
|
|
sudo apt-get install npm nodejs-legacy
|
|
```
|
|
|
|
The `nodejs-legacy` package installs the `node` executable and is currently
|
|
required for `npm` to work on Debian/Ubuntu.
|
|
- TLS certificate and key for HTTPS communication
|
|
- Domain name
|
|
|
|
Before running the single-user notebook servers (which may be on the same
|
|
system as the Hub or not), you will need:
|
|
|
|
- [Jupyter Notebook](https://jupyter.readthedocs.io/en/latest/install.html)
|
|
version 4 or greater
|
|
|
|
## Installation
|
|
|
|
JupyterHub can be installed with `pip` (and the proxy with `npm`) or `conda`:
|
|
|
|
**pip, npm:**
|
|
|
|
```bash
|
|
python3 -m pip install jupyterhub
|
|
npm install -g configurable-http-proxy
|
|
python3 -m pip install notebook # needed if running the notebook servers locally
|
|
```
|
|
|
|
**conda** (one command installs jupyterhub and proxy):
|
|
|
|
```bash
|
|
conda install -c conda-forge jupyterhub # installs jupyterhub and proxy
|
|
conda install notebook # needed if running the notebook servers locally
|
|
```
|
|
|
|
Test your installation. If installed, these commands should return the packages'
|
|
help contents:
|
|
|
|
```bash
|
|
jupyterhub -h
|
|
configurable-http-proxy -h
|
|
```
|
|
|
|
## Start the Hub server
|
|
|
|
To start the Hub server, run the command:
|
|
|
|
```bash
|
|
jupyterhub
|
|
```
|
|
|
|
Visit `https://localhost:8000` in your browser, and sign in with your unix
|
|
credentials.
|
|
|
|
To **allow multiple users to sign in** to the Hub server, you must start
|
|
`jupyterhub` as a *privileged user*, such as root:
|
|
|
|
```bash
|
|
sudo jupyterhub
|
|
```
|
|
|
|
The [wiki](https://github.com/jupyterhub/jupyterhub/wiki/Using-sudo-to-run-JupyterHub-without-root-privileges)
|
|
describes how to run the server as a *less privileged user*. This requires
|
|
additional configuration of the system.
|