How to configure Django

From Webuzo Wiki
Jump to: navigation, search


This guide shows you how to install Django and to create Django Projects and Django Web Applications.

Note: Here Django in not installed in Virtual Environment. If you want to use Django in Virtual Environment, you will have to manually install Django in the created Virtual Environment.

Django Installation

You can install Django from your Webuzo Enduser Panel by searching Django in the search toolbar given on the leftside panel.

Screenshot : Search Django

Search django.png


Once you click on the Django you will be redirected to its installation page. Click on the given Install button in order to start the installation process.

Screenshot : Install Django

Django install form.png

Once completed, you will receive the success message.

Django install success.png

Create a Django Web Project

The following is procedure for creating a test Django web project. You need to have SSH access to your server for creating Django project as well as Django application.


You can create a test Django project by executing the given below commands on the command-line:

# /usr/local/apps/python2/bin/django-admin startproject djangoproject
# cd djangoproject
[djangoproject]# /usr/local/apps/python2/bin/python runserver [your_server_ip_or_domain]:8000
Performing system checks...

System check identified no issues (0 silenced).

Django version 1.11.12, using settings 'djangoproject.settings'
Starting development server at http://[your_server_ip_or_domain]:8000/
Quit the server with CONTROL-C.

Once you have started the web server with the above command, you can now access the project from web browser as follows:

If you get Invalid HTTP_HOST header: [your_server_ip_or_domain]:8000 error then you will have to add your server IP or the domain with which you have executed the django project to the ALLOWED_HOST array in the '' file which can be found at the following location:


Note: The Django Project name 'djangoproject' used here is just for example purpose. You can provide any name you want for your django project.

Once added, refresh your Django Project web page on the web browser which you had opened previously. The page will be seen displaying a message saying 'It worked!' as shown in the below given screenshot:

Screenshot : Django Test Project

Django test project.png

Create a Django Web Application

After successfully creating Django project, you can create a test Django Web App.


You will have to execute the following commands on the command-line for creating a django web app:

[djangoproject]# /usr/local/apps/python2/bin/django-admin startapp djangoapp
  • After creating app, we need to add the newly created app to the list of installed apps in the file of Django project so that Django can refer to it. In order to so, open the file which can be found at
    in a text editor and add Django app to the INSTALLED_APPS list.
[djangoproject]# cd djangoapp
[djangoproject/djangoapp]# mkdir templates
[djangoproject/djangoapp]# cd templates
[djangoproject/djangoapp/templates]# touch index.html
  • Next, open the index.html file created and add the following code in it:
<head><title>Home Page</title></head>
Hello world
  • Once added, execute the below given command:
[djangoproject/djangoapp/templates]# cd ..
  • Once done, open djangoapp/ file and append the following code:
from django.views.generic import TemplateView
class HomeView(TemplateView):
    template_name = 'index.html'
  • After that, execute the below given commands in given order:
[djangoproject/djangoapp/templates]# cd ..
[djangoproject/djangoapp]# cd ..
[djangoproject]# cd djangoproject
  • Open the djangoproject/ file and replace with the below given code:
from django.conf.urls import url
from django.contrib import admin
from djangoapp.views import HomeView
urlpatterns = [
    url(r'^$', HomeView.as_view()),
  • Then execute the below given commands:
[djangoproject/djangoproject]# cd ..
[djangoproject]# /usr/local/apps/python2/bin/python runserver [your_server_ip_or_domain]:8000

Note: The Django Web Application name 'djangoapp' used here is just for example purpose. You can provide any name for your django web application.

Now refresh the Django Project web page which has been opened on the web browser. You will find a Hello World message been displayed on the page.