Deploy a Django project

NOTE: If you are using Django 1.x, you need to replace the python3 command with python.

Development

For development, use the standalone server in Django by executing the following command inside your project folder:

$ python3 manage.py runserver localhost:PORT

You should now be able to browse to your project at http://localhost/APP.

localhost and PORT are optional parameters. 127.0.0.1:8000 will be used by default if you don’t specify any of them. If you plan to remotely access the server, you should use the IP address 0.0.0.0, or the actual server IP address.

IMPORTANT: Remember to open the port used by the Django server in the server firewall. Refer to the FAQ for more information.

Production

For a production environment, we recommend configuring Apache with the mod_wsgi module before starting to serve your application (already installed and activated by default).

• First, modify the WSGI application script file at installdir/apps/django/django_projects/PROJECT/PROJECT/wsgi.py. Remember to replace PROJECT with the actual path and name to your Django project.

TIP: If you are experiencing problems when editing the above file, check if the permissions in your stack are set properly.

Although the exact content may be different depending on your Django version, ensure that the content is similar to the code below and that you add your project to the path with sys.path.append.

    import os
    import sys
    sys.path.append('installdir/apps/django/django_projects/PROJECT')
    os.environ.setdefault("PYTHON_EGG_CACHE", "installdir/apps/django/django_projects/myproject/egg_cache")
    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "PROJECT.settings")
    from django.core.wsgi import get_wsgi_application
    application = get_wsgi_application()

• Create a conf/ folder in the installdir/apps/django/django_projects/PROJECT/ directory.

  $ mkdir installdir/apps/django/django_projects/PROJECT/conf
  

• Create the following files:

  $ touch installdir/apps/django/django_projects/PROJECT/conf/httpd-prefix.conf
  $ touch installdir/apps/django/django_projects/PROJECT/conf/httpd-app.conf
  

• On Linux, you can run the application with mod_wsgi in daemon mode. Add the following code in installdir/apps/django/django_projects/PROJECT/conf/httpd-app.conf:

  <IfDefine !IS_DJANGOSTACK_LOADED>
      Define IS_DJANGOSTACK_LOADED
      WSGIDaemonProcess wsgi-djangostack   processes=2 threads=15    display-name=%{GROUP}
  </IfDefine>
  
  <Directory "installdir/apps/django/django_projects/PROJECT/PROJECT">
      Options +MultiViews
      AllowOverride All
      <IfVersion >= 2.3>
          Require all granted
      </IfVersion>
  
      WSGIProcessGroup wsgi-djangostack
  
      WSGIApplicationGroup %{GLOBAL}
  </Directory>
  
  Alias /PROJECT/static "installdir/apps/django/lib/pythonA.B/site-packages/Django-X.Y.Z-pyA.B.egg/django/contrib/admin/static"
  WSGIScriptAlias /PROJECT 'installdir/apps/django/django_projects/PROJECT/PROJECT/wsgi.py'
  

  NOTE: Where A.B is the Python version (for example 3.6) and X.Y.Z is the Django version (for example 2.0.2).

• In the installdir/apps/django/django_projects/PROJECT/conf/httpd-prefix.conf file, add this code:

  Include "installdir/apps/django/django_projects/PROJECT/conf/httpd-app.conf"
  

• Add the line below to the installdir/apache2/conf/bitnami/bitnami-apps-prefix.conf file:

  Include "installdir/apps/django/django_projects/PROJECT/conf/httpd-prefix.conf"
  

• Edit the installdir/apps/django/django_projects/PROJECT/PROJECT/settings.py file and update the ALLOWED_HOSTS variable with the IP address of your server, as in the example below:

  ALLOWED_HOSTS = ['localhost', 'localhost', '127.0.0.1']
  

• Restart the Apache server:

  $ sudo installdir/ctlscript.sh restart apache
  

You should now be able to browse to your project at http://localhost/PROJECT/APP.

Database configuration

If you wish to configure a database for your project, configure the settings.py file with the following settings. The examples below show how to configure the database connection with a database called “djangostack”.

MySQL

DATABASES = {
  'default': {
      'ENGINE': 'django.db.backends.mysql',
      'NAME': 'djangostack',
      'HOST': 'installdir/mysql/tmp/mysql.sock',
      'PORT': '3306',
      'USER': 'USERNAME',
      'PASSWORD': 'PASSWORD'
  }
}

PostgreSQL

DATABASES = {
  'default': {
      'ENGINE': 'django.db.backends.postgresql_psycopg2',
      'NAME': 'djangostack',
      'HOST': 'installdir/postgresql',
      'PORT': '5432',
      'USER': 'USERNAME',
      'PASSWORD': 'PASSWORD'
  }
}

SQLite

DATABASES = {
  'default': {
      'ENGINE': 'django.db.backends.sqlite3',
      'NAME': 'installdir/apps/django/django_projects/PROJECT/PROJECT/PROJECT.db'
  }
}