Dockerizing a Django Project (part 2)

Installing and running Docker:

If you do not already have Docker installed on your computer, you should install it. Go to and install the Docker Desktop software for your system. I already have it installed.

Start the Docker Desktop app on your system.

Creating the Dockerfile:

Create a file called ./backend/Dockerfile and add the following code:

Note: there are now two backend directories. We will be referring to the first one with the file.

Let’s go over this code:

  • FROM python:3.11.2-slim-buster: We set the base image that will be used to build our image. It uses Python 3.11.2 on Debian Buster (slim version), which is a minimal version of Debian.
  • WORKDIR /usr/src/backend: We set the working directory inside the container to /usr/src/backend. Any subsequent commands will be executed relative to this directory.
  • The following two lines set environment variables for Python. PYTHONDONTWRITEBYTECODE prevents Python from writing pyc files to disk, and PYTHONUNBUFFERED ensures that Python outputs are sent straight to stdout/stderr without being buffered.
  • RUN apt-get update \: We update the package index inside the container.
  • && apt-get -y install netcat gcc postgresql \: We install the necessary packages inside the container. This includes netcat, gcc, and postgresql.
  • && apt-get clean: We clean up the package cache to reduce the size of the Docker image.
  • RUN pip install –upgrade pip: We upgrade pip, the Python package installer, to the latest version.
  • COPY ./requirements.txt /usr/src/backend/requirements.txt: We then copy the requirements.txt file from the host machine into the /usr/src/backend directory in the container.
  • RUN pip install -r requirements.txt: We install the dependencies listed in requirements.txt using pip.
  • COPY ./ /usr/src/backend/ We then copy the script from the host machine into the /usr/src/backend directory in the container.
  • RUN chmod +x /usr/src/backend/ This line makes the script executable.
  • COPY . .: Next, we copy the entire current directory from the host machine into the /usr/src/backend directory in the container. This includes your Python application code.
  • ENTRYPOINT [ “/usr/src/backend/” ]: Finally, we set the default command to execute when the container starts. In this case, it’s the script.

Our Dockerfile is now ready. Next, let’s create the file.

Creating the file:

Create the ./backend/ file and add the following code:

This is a shell script that will run when the container starts. Let’s go over this code:

  • First, the script checks if the $DATABASE environment variable is set to “postgres“.
  • If $DATABASE is set to “postgres“, it waits for the PostgreSQL server to start by repeatedly attempting to connect to it using nc (netcat) until successful.
  • Once PostgreSQL is up, it echoes “PostgreSQL started”.
  • It then flushes the database using python flush –no-input, which clears all data from the database without asking for confirmation.
  • Finally, it runs Django migrations using python migrate.
  • exec “$@” is used to execute any additional command-line arguments passed to the script.

Before we move to the next, we will need to make the file executable as a program. To do that, run the command:

Creating the Docker-compose file:

Create the docker-compose.yml file inside the root directory of your project and add the following code:

This configuration sets up two services: backend and database. Let’s go over them:

  • backend service:
    • build: ./backend: This line specifies that the Dockerfile for the backend service is located in the ./backend directory.
    • command: python runserver This is the command that will be executed when the container starts. It runs a Django server listening on all available network interfaces ( on port 8000.
    • volumes: ./backend/:/usr/src/backend/: This mounts the local ./backend/ directory into the container at /usr/src/backend/. This is useful for development, as it allows you to make changes to your code without needing to rebuild the Docker image.
    • ports: 8000:8000: This maps port 8000 of the host machine to port 8000 of the container, allowing you to access the Django server from your host machine.
    • env_file: ./backend/.env: This specifies an environment file containing environment variables for the backend service. These variables are used by Django for configuration.
    • depends_on: – database: This ensures that the backend service waits for the database service to be fully started before starting itself. However, it doesn’t wait for the database to be ready to accept connections.
  • database service:
    • image: postgres:15: This line specifies the Docker image to use for the database service. It pulls the PostgreSQL version 15 image from Docker Hub.
    • volumes: postgres_data:/var/lib/postgresql/data/: This creates a Docker volume named postgres_data and mounts it to the PostgreSQL data directory within the container. This ensures that data persists between container restarts.
    • environment: – POSTGRES_USER=backend – POSTGRES_PASSWORD=backend – POSTGRES_DB=backend_db’: These environment variables configure the PostgreSQL database:
      • POSTGRES_USER: Sets the username for the database to backend.
      • POSTGRES_PASSWORD: Sets the password for the backend user to backend.
      • POSTGRES_DB: Sets the name of the default database to backend_db.
    • volumes:
      • postgres_data: This defines a named volume for storing PostgreSQL data. Named volumes are a way to persist data generated by Docker containers.

This configuration sets up a development environment for a Django application with a PostgreSQL database. The backend service runs the Django server, while the database service provides the PostgreSQL database backend.

Creating the environment file:

As mentioned above, we will use an environment file called .env to keep our environment variables. We will only use this for development purposes. Create the ./backend/.env file and add the following code:

Let’s go over this code:

  • DEBUG=1: The DEBUG setting takes a true or false value. When set to true, it enables Django’s debug mode, which provides detailed error pages when an error occurs. The environment file can only take boolean values; we therefore set it to 1 which will be converted to an integer later in our file. Note: debug mode should be enabled only during development, not in production.
  • SECRET_KEY=foo: This is a cryptographic key used by Django for session management, CSRF protection, and other security-related functionality. It should be a long, random string and kept secret. In this case, it’s set to a placeholder value foo, which is not secure for production use.
  • DJANGO_ALLOWED_HOSTS=localhost [::1]: This variable specifies a list of host/domain names that the Django application is allowed to serve. In this case, it allows requests from localhost,, and [::1] (IPv6 loopback address).
  • SQL_ENGINE=django.db.backends.postgresql: This specifies the database backend engine for Django. It’s set to use PostgreSQL.
  • SQL_DATABASE=backend_db: This is the name of the PostgreSQL database that Django will use.
  • SQL_USER=backend: This is the username for accessing the PostgreSQL database.
  • SQL_PASSWORD=backend: This is the password for the PostgreSQL user specified above.
  • SQL_HOST=backend-db: This is the hostname of the PostgreSQL database server. In this case, it’s set to backend-db, which corresponds to the service name defined in our Docker Compose file (database service).
  • SQL_PORT=5432: This is the port on which the PostgreSQL database server is listening. The default port for PostgreSQL is 5432.

These environment variables are essential for configuring our Django application to connect to the PostgreSQL database service defined in our Docker Compose configuration. Note: Make sure to replace placeholder values like foo and backend with secure and appropriate values, especially in a production environment.

Updating the file:

We need to update the file to use the environment variables defined above.

First import the os python module with the command below.

We will use the os module to access the environment variables by using os.environ.get(). The os.environ.get() method is used to retrieve the value of an environment variable. It takes one argument, which is the name of the environment variable you want to retrieve.

Next, let’s make sure that the SECRET_KEY, DEBUG and ALLOWED_HOSTS settings get their values from the environment file. Update them as shown below:

Let’s go over the code:

  • SECRET_KEY is set to the value of the environment variable named ‘SECRET_KEY‘.
  • DEBUG is set to the integer value of the environment variable named ‘DEBUG‘. Note: The os.environ.get() method returns a string so we need to convert it to an integer with the int() method.
  • ALLOWED_HOSTS is set to a list of host/domain names obtained by splitting the value of the environment variable named ‘DJANGO_ALLOWED_HOSTS‘ using the space character as a delimiter. Note: This way we can allow multiple host or domain names.

Finally, let’s update the database settings to use the environment variables as well.

Just like before we are using the os.environ.get() method to set the database settings values. However, in this case, we are passing in a second argument that represents the default value in case the environment variable cannot be found.

Your project should look like this.

Note: You can refer to the project source code to check that you have the same project structure.

The dockerization is now done. Let’s test that it’s working.

Running our app in docker:

First, we will need to build the image by running the command below in your project root folder (where you have the docker-compose.yml file):

After the image has been built, we can now run the container with the following command:

Note: We could have run the following command to both build the image and run the container.

Your container should be running and your services should be up. The output should be something like below:

To check that the services are running you can use the following command:

This command will show all the running containers.

Go to in your browser to see your app running.

That’s it. We were successfully able to dockerize our Django application.

Further learning:

To learn more about the different technologies we used you can go to:

Project source code:

You can find the entire source of the project here.

Dockerizing a Django Project (part 1)

In this tutorial, I will show you how to dockerise a Django project. After completing it, you will have a base for your future Django projects.


This is not an introductory Django course so I am assuming that:

  • You have a working knowledge of the Django framework and the Python programming language.
  • You are comfortable writing shell commands and running commands in the terminal.
  • You already have Python installed. Version 3 preferably

Therefore I will not be going into details about some of the concepts in this tutorial.

Create the project directories:

We first created the tutorial-dockerize-django directory that will contain all the files for our project. We then create the backend directory that will keep all the files related to the backend. This is useful when we will also need to create our frontend or mobile app.

Creatig and activating the virtual environment:

The first lines create the virtual environment called env in this case and on the second line we activate it. Note: the (env) in your command prompt.

Installing dependencies:

We will need to install the Django package to be able to create a django project. First, let’s create a requirements.txt file inside the backend directory and add the following code:

These commands will install the Django package as well as the psycopg2-binary package that will be needed for us to be able to use PostgreSQL as a database with our Django app.

To actually install the packages, run the command below inside your backend directory:

This will read the content of the requirements.txt file and install any packages listed in it, inside our virtual environment.

If you want to check that the packages have been installed, you can run the command:

Django is installed so we can now create our project.

Creating the Django project:

We use django-admin to create a new project called backend. By default, this command will create a new directory called backend. However, since we are already inside a backend directory so we use the “.” to indicate that the current directory should be used to hold the project files instead of creating a new one.

This command will generate the project with all the necessary files. Your project should look like this:

We can test our project by running the following command:

This will start our project at You can visualise it in your browser.

Our base project is good to go. The next step is to dockerize the project.

Revolutionising Healthcare: The Role of Artificial Intelligence

Artificial Intelligence (AI) has emerged as a transformative force in healthcare, revolutionising the way medical services are delivered, diagnoses are made, and patient outcomes are improved. By leveraging advanced algorithms, machine learning, and predictive analytics, AI empowers healthcare providers with the ability to analyse vast amounts of data, identify patterns, and make data-driven decisions in real-time. In this article, we explore the multifaceted role of artificial intelligence in revolutionising healthcare delivery. Continue readingRevolutionising Healthcare: The Role of Artificial Intelligence

Navigating Product Ownership in Remote Teams: Strategies for Success

As remote work becomes increasingly prevalent, product owners must adapt their practices to effectively lead distributed teams. Product ownership in remote settings presents unique challenges, including communication barriers, collaboration hurdles, and maintaining team morale from a distance. In this article, we’ll explore insights and best practices for product owners to navigate these challenges and foster success in remote or distributed teams. Continue readingNavigating Product Ownership in Remote Teams: Strategies for Success

Embracing Iteration: The Key to Successful Product Development

In the realm of product development, where uncertainty is inevitable and user needs are constantly evolving, adopting an iterative approach is essential for success. Iterative product development involves building, testing, and refining products in successive cycles, incorporating feedback and insights from users along the way. In this article, we’ll explore the benefits of iterative product development and how teams can continuously improve products through feedback and experimentation. Continue readingEmbracing Iteration: The Key to Successful Product Development

Interoperability in Health Informatics: Breaking Down Data Silos for Seamless Care Delivery

In the complex landscape of healthcare, interoperability stands as a critical enabler for delivering seamless and patient-centered care. Interoperability in health informatics refers to the ability of diverse healthcare systems and applications to exchange, interpret, and use data seamlessly across organisational boundaries. By breaking down data silos and facilitating the seamless flow of information, interoperability enhances care coordination, improves clinical decision-making, and ultimately, enhances patient outcomes. In this article, we delve into the importance of interoperability and its impact on healthcare delivery. Continue readingInteroperability in Health Informatics: Breaking Down Data Silos for Seamless Care Delivery

The Power of Cross-Functional Collaboration in Product Delivery

In the dynamic world of product development, success hinges not only on the brilliance of individual team members but also on the synergy and collaboration among different functions. Cross-functional collaboration brings together diverse perspectives, expertise, and skills to drive innovation, mitigate risks, and deliver products that delight customers. In this article, we’ll explore the importance of cross-functional collaboration between product management, engineering, design, marketing, and other teams for successful product delivery. Continue readingThe Power of Cross-Functional Collaboration in Product Delivery

Telemedicine: Bridging Healthcare Access Gaps

Telemedicine has emerged as a transformative solution to address disparities in healthcare access, particularly for individuals facing geographical, financial, or logistical barriers. By leveraging digital technologies to deliver remote medical services, telemedicine facilitates timely access to healthcare providers, enhances patient convenience, and improves healthcare outcomes. In this article, we explore how telemedicine is bridging gaps in healthcare access and transforming the delivery of healthcare services. Continue readingTelemedicine: Bridging Healthcare Access Gaps

Deciphering Success: Product Metrics and KPIs Demystified

In the ever-evolving landscape of product management, data-driven decision-making reigns supreme. Product metrics and Key Performance Indicators (KPIs) serve as the compass that guides product development efforts, enabling teams to track progress, measure success, and make informed decisions. In this article, we’ll explore the importance of product metrics and KPIs, how to identify them, and best practices for measuring them to drive product success. Continue readingDeciphering Success: Product Metrics and KPIs Demystified