README.md

Voila application deployed on Heroku

This is an example of Voila deployed on Heroku, try it out: https://voila-heroku-demo.herokuapp.com

How to deploy your own?

1. First, create an Heroku account (free account is fine for testing)

2. Install Heroku on your machine: https://devcenter.heroku.com/articles/getting-started-with-python#set-up

3. Clone this repository, or create your own repository that follows the same structure:

git clone https://github.com/voila-dashboards/voila-heroku
cd voila-heroku

3. Create your Notebook and put it in the notebooks directory

4. Add the dependencies needed for running your Notebook in the requirements.txt file

5. Edit the Procfile file by replacing notebooks/bqplot.ipynb by the path to your awesome Notebook

6. Commit everything

git commit -m "My awesome app on Heroku!"

8. Create the Heroku app:

heroku create

9. Now deploy your code:

git push heroku master

10. That's it! Easy right? Now you can open your app using:

heroku open

Note that this last command is only a handy shortcut for opening your browser following the right url, you can also do that manually.

Extra steps

• You can rename your application on the Heroku website, in the applicaion settings. If you rename it, don't forget to update the remote repository doing git remote remove heroku && git remote add heroku https://git.heroku.com/your-application-name.git
• You can add/remove/update voila command line arguments in the Procfile file, e.g. you can use the dark theme by adding --theme=dark