To deploy an app first create an account.

Voila applications#

To deploy an application you need two files:

  1. A Jupyter notebook file (.ipynb)

  2. A dependencies file (requirements.txt)

For information on how to write Voilà applications, please check the documentation.

Note that the application will run with Python 3.11. Refer to this section for customized deployments. Here is a sample Docker-based Voila application.


To deploy a new project, list your dependencies in a (requirements.txt). For example, if you’re using JupySQL, pandas and matplotlib, your requirements.txt file will look like this:

# sample requirements.txt


Deploy from the menu

Once you have all your files, create a zip file.

To deploy a Voilà app from the deployment menu, follow these instructions:

Try an example

To download and deploy an example Voila application start by installing Ploomber Cloud and setting your API key:

pip install ploomber-cloud
ploomber-cloud key YOUR-KEY


If you don’t have an API key yet, follow the instructions here.

Now, download an example. It will prompt you for a location to download the app. To download in the current directory, just press enter.

ploomber-cloud examples voila/chat-with-csv

You should see a confirmation with instructions on deploying your app. Now, navigate to your application:

cd location-you-entered/chat-with-csv

Deploy from the CLI

Initialize and deploy your app with:

ploomber-cloud init
ploomber-cloud deploy --watch


To ensure your app doesn’t break on re-deployments, pin your dependencies.

Production deployments#

Ploomber has features to help you deploy production-ready Voila apps


Our integration with Auth0 allows you to easily add authentication to any Voila app. There’s no need to modify your Voila app code, only pass your Auth0 configuration parameters. Check out the sample app.


Ploomber Cloud supports many features to help you build Voilà applications quickly!