Get started with Django

To get started, we suggest the following steps:

Step 1. Create a new Django project

  • First, create a new folder to store your Django projects, such as the /opt/bitnami/projects directory, and give write permissions for the current system user:

    $ sudo mkdir /opt/bitnami/projects
    $ sudo chown $USER /opt/bitnami/projects
  • Then, initialize a new Django project with the following command:

    $ django-admin startproject PROJECT /opt/bitnami/projects/PROJECT

Configure database credentials

If you wish to configure a database for your project, you will need to configure the database credentials in the file. The examples below show how to configure the database connection with a database called “PROJECT”.

NOTE: Replace the USERNAME and PASSWORD placeholders with your database user and password, respectively. Learn how to obtain the database credentials.

  • SQLite:

        'default': {
            'ENGINE': 'django.db.backends.sqlite3',
            'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
  • MariaDB:

        'default': {
            'ENGINE': 'django.db.backends.mysql',
            'NAME': 'PROJECT',
            'HOST': '/opt/bitnami/mariadb/tmp/mysql.sock',
            'PORT': '3306',
            'USER': 'USERNAME',
            'PASSWORD': 'PASSWORD'
  • PostgreSQL:

        'default': {
            'ENGINE': 'django.db.backends.postgresql_psycopg2',
            'NAME': 'PROJECT',
            'HOST': '/opt/bitnami/postgresql',
            'PORT': '5432',
            'USER': 'USERNAME',
            'PASSWORD': 'PASSWORD'

Create project database and initialize the schema

To create the project database and initialize the schema for your Django project, change to your project directory and run the following command:

$ python migrate

Add a sample application with a welcome page

By default, Django does not add any application to your project. To add a application, follow the steps below:

  • Create the helloworld application:

    $ python startapp helloworld
  • Edit the helloworld/ file and ensure it contains the following:

    from django.http import HttpResponse
    def index(request):
        return HttpResponse("Hello, world.")
  • Create and edit the helloworld/ file and ensure it contains the following:

    from django.urls import path
    from . import views
    urlpatterns = [
        path('', views.index, name='index'),
  • Edit the PROJECT/ file and ensure it contains the following:

    from django.contrib import admin
    from django.urls import include, path
    urlpatterns = [
        path('', include('helloworld.urls')),

Test your Django project

The Django project can be started by using this command from the /opt/bitnami/projects/PROJECT directory, and it will run on port 8000:

$ python runserver

To access the application, browse to http://SERVER-IP:8000/. To end the application, terminate the running Django process.

Step 2. Serve your application through the Apache Web server

For a production environment, it is recommended to configure Apache with the mod_wsgi module before serving your application. For more information, refer to these instructions.

Step 3: Create an HTTPS certificate for Apache

To learn how to create an HTTPS certificate for Apache, refer to the auto-configure a Let’s Encrypt certificate section.

Last modification July 1, 2020