Simple repo to get started on Heroku to serve static files using Python Tornado
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


This is a very simple package which should get you started on Heroku to serve static files using Python Tornado. Knowledge of Python or Tornado is not required.

It can be used for serving a static blog or your personal portfolio page etc. You can check the demo here

How to deploy on Heroku:

  • Make sure you already have an account on Heroku and you have set up your local machine.
  • Run heroku login command in terminal, enter your email and password. If you get 'Authentication successful.' then your machine is setup.
  • Download the zip or clone this repo by running following : git clone
  • cd into the heroku-tornado-starter
  • Run this to create an app on Heroku: heroku create --stack cedar
  • Now push the repo to heroku by running: git push heroku master
  • Done ! Run heroku open to open your site in browser.
  • Bro tip : rename the app by following : heroku apps:rename new-name

Feeling lazy? Run the script, it will do all the steps for you!

So, what next?

Make changes to index.html as required. This is the default file which will be served whenever someone visits your site. Do not rename or remove this file. You can add more HTML files and keep them in same directory or in subdirectory. You can add/modify stylesheets under assets/css and javascripts under assets/js directory. All the paths are relative and specified with respect to root directory i.e. '/'

To keep things clean, move all your images to assets/images and other assets to respective directories. You can link them in your HTML with path relative to root. e.g. <link rel="stylesheet" href="/assets/css/style.css">

Once all required changes are made, commit them and then run git push heroku master. Done! 😎