Skip to main content

A server extension for the JupyterLab Heroku extension

Project description


npm pypi

JupyterLab extension to manage and deploy applications to Heroku.

The extension enables 1-click deployments of voila dashboards.



Create an Heroku account

If you already have an Heroku account, you can skip to the next section.

You can create a new Heroku account by following these instructions:

Install the heroku client

You need the heroku client installed on your machine to be able to deploy applications. To set it up:

Once the setup is complete, test the installation with:

$ heroku --version
heroku/7.26.2 linux-x64 node-v11.14.0

Login to Heroku

There are different ways to login to Heroku:

  1. heroku login will open a new browser tab to log in with the email and password
  2. create a ~/.netrc file with the api token (see the documentation for more details)
  3. set the HEROKU_API_KEY environment variable

To test the authentication: heroku apps

Other Dependencies

This extension also requires:

  • JupyterLab 1.0
  • git


pip install jupyterlab-heroku
jupyter serverextension enable --sys-prefix --py jupyterlab_heroku
jupyter labextension install jupyterlab-heroku

Since Heroku uses git to deploy applications, it is also recommended to install the jupyterlab-git extension for JupyterLab:

pip install jupyterlab-git
jupyter serverextension enable --sys-prefix --py jupyterlab_git
jupyter labextension install @jupyterlab/git



# Clone the repo to your local environment
# Move to jupyterlab-heroku directory

# Create a new conda environment
conda create -n jupyterlab-heroku -c conda-forge jupyterlab nodejs

# Install the server extension
python -m pip install -e .
jupyter serverextension enable --sys-prefix --py jupyterlab_heroku

# Install dependencies

# Build Typescript source
jlpm build

# Link your development version of the extension with JupyterLab
jupyter labextension link .

# Rebuild Typescript source after making changes
jlpm build

# Rebuild JupyterLab after making any changes
jupyter lab build

You can watch the source directory and run JupyterLab in watch mode to watch for changes in the extension's source and automatically rebuild the extension and application.

# Watch the source directory in another terminal tab
jlpm watch

# Run jupyterlab in watch mode in one terminal tab
jupyter lab --watch


jupyter labextension uninstall jupyterlab-heroku


To deploy Voila applications to Heroku using the command line:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for jupyterlab-heroku, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size jupyterlab_heroku-0.2.1-py3-none-any.whl (6.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size jupyterlab_heroku-0.2.1.tar.gz (4.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page