Name Last Update
ipython_odl Loading commit data...
.gitignore Loading commit data...
LICENSE.txt Loading commit data...
MANIFEST.in Loading commit data...
README.md Loading commit data...
README.txt Loading commit data...
clear Loading commit data...
install.sh Loading commit data...
jupyterhub_config.py.patch Loading commit data...
requirements.txt Loading commit data...
setup.py Loading commit data...
sqlite_auth.py Loading commit data...
virtual_user_spawner.py Loading commit data...

README.md

JupyterHub installation script

The script requires sudo privileges to install mandatory tools (NodeJS). It also needs two versions of Python to be installed:

  • Python 2.7.x (with a "python2" alias) with pip ("pip2")
  • Python 3.n ("python") with pip ("pip").

The script installs Python packages at the system level using sudo but it should be possible to install these as user using the --user option in pip commands.

1 - Edit the install.sh file to change how system packages are installed (Debian apt-get by default)

2 - Edit line 27 of sqlite_auth.py to change the salt used to produce password hashes

3 - Run the install.sh script

If everything went fine, a script named "start_notebooks" has been created and can be used to launch JupyterHub with an SQLite user database and a spawner that creates a workspace for each user.

Notebooks that you put in the "presets" directory (created during installation) will be copied in user workspaces when users log in (if a notebook with the same name already exists in the workspace, it will not be overwritten).