This document will assist you in upgrading an existing JupyterHub deployment from version 0.7 to version 0.8.
jupyterhub.sqlite
when using the default sqlite databasejupyterhub_config.py
pip install -U jupyterhub
when using pip
conda upgrade jupyterhub
when using conda
`jupyterhub upgrade-db
jupyterhub_config.py
To prevent unintended loss of data or configuration information, you should back up the JupyterHub database (the default SQLite database or a RDBMS database using PostgreSQL, MySQL, or others supported by SQLAlchemy):
jupyterhub.sqlite
database.Note
Losing the Hub database is often not a big deal. Information that resides only in the Hub database includes:
If the following conditions are true, you should be fine clearing the Hub database and starting over:
Backup up your configuration file, jupyterhub_config.py
, to a secure
location.
Follow directions that correspond to your package manager, pip
or conda
,
for the new JupyterHub release:
pip install -U jupyterhub
for pip
conda upgrade jupyterhub
for conda
Upgrade the proxy, authenticator, or spawner if needed.
To run the upgrade process for JupyterHub databases, enter:
jupyterhub upgrade-db
Create a new JupyterHub configuration file or edit a copy of the existing
file jupyterhub_config.py
.
Start JupyterHub with the same command that you used before the upgrade.