Deploying Django on Heroku - A Comprehensive Guide


Heroku is a popular cloud platform that simplifies the deployment of web applications. In this comprehensive guide, we'll explore the process of deploying a Django project on Heroku, complete with sample code and best practices.


Before you begin, make sure you have the following prerequisites in place:

  • Django Project: You should have a fully developed Django project ready for deployment.
  • Heroku Account: Sign up for a Heroku account if you haven't already.
  • Heroku CLI: Install the Heroku Command Line Interface (CLI) to manage your Heroku apps.
  • Version Control (Optional): Using version control with Git is recommended for efficient deployment and maintenance.

Step 1: Prepare Your Django Project

Before deploying to Heroku, ensure that your Django project is well-structured and configured correctly for production.

Sample Django Configuration

Example settings for your Django project's</</p> file:
DEBUG = False
ALLOWED_HOSTS = ['', '']

Step 2: Set Up a Heroku App

Create a new Heroku app using the Heroku CLI. This will also set up a Git repository for your project.

Sample Heroku App Creation

Run the following commands to create a Heroku app:

heroku login
git init
heroku create yourherokuapp

Step 3: Configure PostgreSQL Database (Optional)

Heroku uses PostgreSQL as its default database. You can add the Heroku Postgres add-on to your app.

Sample PostgreSQL Configuration

Add the Heroku Postgres add-on to your app with the following command:

heroku addons:create heroku-postgresql:hobby-dev

Step 4: Deploy Your Django Project

Deploy your Django project to Heroku using Git. This step pushes your code to the Heroku app's repository and triggers the deployment process.

Sample Deployment Script

Use the following commands to deploy your Django project to Heroku:

git add .
git commit -m "Initial deployment"
git push heroku master

Step 5: Open Your App

Once the deployment is successful, open your app in a web browser using the provided Heroku URL.


Deploying a Django project on Heroku is a straightforward process, and Heroku provides a convenient platform for hosting web applications. This guide covers the essential steps to get your project up and running. Be sure to adapt these steps to your specific project requirements and hosting environment.