# Quickstart

## Prerequisites

Before installing JupyterHub, you will need:

Before running the single-user notebook servers (which may be on the same system as the Hub or not), you will need:

## 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.