Beginners Guide to Installing and Configuring Django on Linux

Beginners Guide to Installing and Configuring Django on Linux

Django is a web framework for python. It provides you with the basic components that are required to build your website like HTML templates, User Authentication, Web Server etc.
In this tutorial I will describe how you can install Django 1.7 on Linux with the latest version of Python and PostgreSQl.

Software Versions
Linux(CentOS 6.5)
Python 3.4
Django 1.7
PostgresSQL 9

Step 1: Install Python 3.4 on your Linux machine.
Ubuntu/Mint/Raspberry Pi users can skip this step as these distro’s generally have the latest versions of python (check by running “python –version”)

[leo@django~]$ wget
[leo@django~]$ tar -xvzf Python-3.4.2.tgz
[leo@django~]$ cd Python-3.4.2
[leo@django~]$ ./configure
[leo@django~]$ make
[leo@django~]$  sudo make altinstall
[leo@django~]$   python --version
Python 3.4.2

Step: 2 Install Django on Linux

Before you install Django create a virtual environment, where the project dependencies will be installed and will not conflict with system dependencies.

[leo@django~]$ pyvenv-3.4 venv3.4
[leo@django~]$ source venv3.4/bin/activate
[leo@django~]$ pip install django

Step 3: Install PostgreSQL 9.4 on Linux

Django recommends the use of PostgreSQL for it’s database operations. If you are not comfortable with Postgres, then you can configure MySQL or you can leave the settings to default and use SQLlite as well. Ubuntu/Mint/RasberryPi users can follow the PostgreSQL installation guide at

[leo@django~]$ sudo vim /etc/yum.repos.d/CentOS-Base.repo
#add the below line to the base and update sections
[leo@django~]$ sudo yum localinstall
[leo@django~]$ sudo yum install postgresql94-server postgresql94-contrib postgresql-devel
[leo@django~]$ sudo /usr/pgsql-9.4/bin/postgresql94-setup initdb
[leo@django~]$ sudo  service postgresql-9.4 initdb
[leo@django~]$ sudo service postgresql-9.4 start

Create a Database and assign a user to it.

[leo@django~]$ sudo  su - postgres
 [postgres@django~]$ createdb yourdbname
 [postgres@django~]$ createuser -P yourdbuser   #createuser will prompt you for a password, enter it twice.
 [postgres@django~]$ psql
 postgres=# GRANT ALL PRIVILEGES ON DATABASE yourdbname TO yourdbuser;
 postgres=# \q

Now try to connect via the command prompt

[leo@django~]$ psql -U yourdbusername -h localhost -W yourdbname

After you enter you password you will get the below error
“FATAL: Ident authentication failed for user”

This is because by default PostgreSQL uses ‘ident’ authentication i.e it checks if the username exists on the system. You need to change authentication mode to ‘md5’ as we do not want to add a system user.
Modify the settings in “pg_hba.conf” to use ‘md5’ authentication.

[leo@django~]$ sudo  vim /var/lib/pgsql/9.4/data/pg_hba.conf
# "local" is for Unix domain socket connections only
local all all md5
# IPv4 local connections:
host all all md5
# IPv6 local connections:
host all all ::1/128 md5

[leo@django~]$ sudo service postgresql-9.4 restart

Install the PostgreSQL driver psycopg2

[leo@django~]$PATH=$PATH:/usr/pgsql-9.4/bin/ pip install psycopg2 

Step 4: Create your first Django website

[leo@django]$ startproject website
[leo@django]$ cd website
[leo@django website]$ vim website/

    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'USER': 'yourdbusername',
            'PASSWORD': 'yourdbpassword',
            'HOST': 'localhost',                      
            'PORT': '',

[leo@django website]$ python website/ syncdb #Enter a admin user name and password for Django
#Run the server
[leo@django website]$ python website/ runserver

You should be able to access the site at the url and the admin panel at
install django 1.7 on linux

To add your own index template add the following code to

[leo@django website]$ vim website/
TEMPLATE_DIRS = [os.path.join(BASE_DIR, 'templates')]

Create a templates folder and add your index.html file in it along with the default admin templates.

[leo@django website]$ mkdir templates
[leo@django ~]$ cp -rv venv3.4/lib64/python3.4/site-packages/django/contrib/admin/templates/*  website/templates/
[leo@django~]$vim website/index.html

Hi this is Leo and This is my first website on Linux

Finally modify your file to look as follows.

[leo@django~]$ vim website/website/

from django.conf.urls import patterns, include, url
from django.contrib import admin
from django.views.generic.base import TemplateView

urlpatterns = patterns('',
    # Examples:
    # url(r'^$', 'blog.views.home', name='home'),
    # url(r'^blog/', include('blog.urls')),

    url(r'^admin/', include(,
    url(r'^$', TemplateView.as_view(template_name='index.html'), name="home"),

Now run your server

[leo@django website]$ python website/ runserver
Performing system checks...

System check identified no issues (0 silenced).
February 02, 2015 - 10:44:18
Django version 1.7.4, using settings 'website.settings'
Starting development server at
Quit the server with CONTROL-C.
[02/Feb/2015 10:44:21] "GET / HTTP/1.1" 200 1759

Now you can design your own templates or you can use pre-built ones from

Here are some references to help you design your own template.

Follow me

Leo G

Is a Linux Hobbyist and Enthusiast. He Strongly believes in OpenSource Software and would like you to view and download his software at
Follow me

  • Pingback: Here’s how you can start building websites on Linux with Django | 4an Nyheter()

  • Pingback: How to install Django on Linux | Zbyněk Svoboda()

  • Pingback: How to install Django on Linux | Linux Admins()

  • Pingback: Links 4/2/2015: X.Org Server 1.17, ContainerCon | Techrights()

  • Pingback: How to install Django on Linux | TutorTechs()

  • Pingback: Links 5/1/2016: NVIDIA Shows Linux Some Love, Black Lab Enterprise Linux 8.0 DP3 | Techrights()

  • ray smith

    I appreciate your work. As I’m very new to Django and Web administration, my actions and questions may be very naive.
    I’m using a Fediora system. I tried using the default (sqlLite)
    upon executing:
    [ray.smith@ray_network website]$ emacs website/
    I see a lot but the Database area looks like the following:
    # Database



    ‘default’: {

    ‘ENGINE’: ‘django.db.backends.sqlite3’,

    ‘NAME’: os.path.join(BASE_DIR, ‘db.sqlite3’),



    which I leave as is.

    I then, execute the next command:

    (venv3.4) [ray.smith@ray_network website]$ python website/ syncdb

    python: can’t open file ‘website/’: [Errno 2] No such file or directory


    I see there is no “website/website/” but there is a .”website/” so I try that –

    (venv3.4) [ray.smith@ray_network website]$ python ./ syncdb

    Unknown command: ‘syncdb’

    Type ‘ help’ for usage.

    Also from one level up –

    (venv3.4) [ray.smith@ray_network django]$ python website/ syncdb

    Unknown command: ‘syncdb’

    Type ‘ help’ for usage.

    I apologize if this is the wrong place to ask the questions.
    Thanks for your consideration

    • Leo G

      try “python migrate”

    • ray smith

      Thanks a bunch Leo!
      The “python migrate”, followed by “python runserver”, both executed from the upper “website” directory worked great.
      For those who might have to follow the same path:
      (venv3.4) [ray.smith@ray_network website]$ python migrate

      Operations to perform:

      Apply all migrations: sessions, auth, contenttypes, admin

      Running migrations:

      Rendering model states… DONE

      Applying contenttypes.0001_initial… OK

      Applying auth.0001_initial… OK

      Applying admin.0001_initial… OK

      Applying admin.0002_logentry_remove_auto_add… OK

      Applying contenttypes.0002_remove_content_type_name… OK

      Applying auth.0002_alter_permission_name_max_length… OK

      Applying auth.0003_alter_user_email_max_length… OK

      Applying auth.0004_alter_user_username_opts… OK

      Applying auth.0005_alter_user_last_login_null… OK

      Applying auth.0006_require_contenttypes_0002… OK

      Applying auth.0007_alter_validators_add_error_messages… OK

      Applying sessions.0001_initial… OK

      (venv3.4) [ray.smith@ray_network website]$ python runserver

      Performing system checks…

      System check identified no issues (0 silenced).

      May 25, 2016 – 20:47:00

      Django version 1.9.6, using settings ‘website.settings’

      Starting development server at

      Quit the server with CONTROL-C.