Installing and Configuring Django Web Framework with Virtual Environments in CentOS/Debian – Part 1

“This article is revised and updated with latest version of Django – May 2016” Some 20 years ago when the World Wide Web was still in its infancy, having a personal or business web...

Spread the love

“This article is revised and updated with latest version of Django – May 2016”

Some 20 years ago when the World Wide Web was still in its infancy, having a personal or business web site was almost a rare luxury. With the subsequent development of several web technologies and the introduction of dynamic content provided by the combination of server-side programs and databases, companies could no longer be satisfied with having a static web site.

Setup Django Web Framework in CentOS Debian

Install and Configure Django in CentOS and Debian – Part 1

Thus, web applications became a reality – programs in the full sense of the word running on top of a web server and accessible through a web browser.

To make development easier and more effective, web frameworks were designed to aid programmers in their efforts to create applications. In short, a web framework takes care of common core functionalities in the development process such as dealing with user session management, interaction with databases, and the good practice of keeping business logic separate from display logic, to name a few examples.

In this 3-article Django series, we will introduce you to Django, a popular web framework based on Python. For that reason, at least a little familiarity with this programming language is suggested but if you have little to no experience with it, we’ll also walk you through the basics.

Part 1: Installing and Configuring Django Web Framework with Virtual Environments in CentOS/Debian

Installing Django in CentOS and Debian Servers

Although you can install Django from both the Debian (v1.7.7: extended support will be discontinued on December 2015) and Fedora EPEL (v1.6.11: extended support was discontinued on April 2015) repositories, the available version is not the latest stable LTS (Long Term Support) release (v1.8.13, as of May 2016).

In this tutorial we will show you how to install Django v1.8.13 since its extended support is guaranteed until at least April of 2018.

The recommended method to install Django is through pip, a popular tool for managing Python packages. Also, in order to create isolated Python environments and avoid conflicts between projects that may require different versions of software dependencies, the use of virtual environments is highly encouraged.

The tools that are used to create and manage virtual Python environments is called virtualenv.

Follow these steps to perform the installation:

1. For Fedora-based distributions (except in Fedora itself), enable the EPEL repository first:

# yum update && yum install epel-release

2. Install pip and virtualenv:

Fedora-based distros:
# yum install python-pip python-virtualenv
OR # dnf install python-pip python-virtualenv
Debian and derivatives:
# aptitude update && aptitude install python-pip virtualenv

3. Create a directory to store your initial project.

# mkdir ~/myfirstdjangoenv
# cd ~/myfirstdjangoenv

4. Create and activate a virtual environment:

# virtualenv myfirstdjangoenv

The above command creates a bunch of files and subdirectories into ~/myfirstdjangoenv and basically installs a local copy of Python and pip within the current working directory. Next, we need to activate the virtual environment we just created:

# source myfirstdjangoenv/bin/activate

5. Notice how the command prompt changes after the last command. It’s now time to install Django:

Note that the below screenshot was taken during a previous version of this tutorial, but the expected output is the same when installing Django 1.8.13):

# pip install Django==1.8.13
Install Django in Linux

Install Django in Linux: CentOS and Debian

You can check the Django version by launching a Python shell from your current working directory:

# python
>>> import django
>>> print(django.get_version())

(Again, the above command should return 1.8.13 when checking the current Django version).

To exit the Python prompt, type:

>>> exit() 

and press Enter. Next, turn off the virtual environment:

# deactivate
Deactive Django Virtual Environment

Deactive Django Virtual Environment

Please note that while the virtual environment remains deactivated, Django is not available:

Django Error

Django Error

How to Create a First Project in Django

To create a project within the virtual environment we created earlier, it needs to be activated:

# source myfirstdjangoenv/bin/activate

Next, the framework will create the entire directory structure to store your project. To do this, you will need to run.

# django-admin startproject myfirstdjangoproject

The above command will create a directory named myfirstdjangoproject inside your current working directory.

where you will find a file named (an utility that will help you manage your project later on) and another subdirectory (~/myfirstdjangoenv/myfirstdjangoproject/myfirstdjangoproject). This last subdirectory will serve as the container for the project files.

While the rest of the files will make real sense after we have reviewed some Python to start writing a real web application, it is worth and well to take note of the key files that will be found inside a project container directory:

  1. myfirstdjangoproject/ This empty file tells Python that this directory should be considered a Python package.
  2. myfirstdjangoproject/ Specific settings for this Django project.
  3. myfirstdjangoproject/ a TOC (Table Of Contents) of your Django-powered site.
  4. myfirstdjangoproject/ An entry-point for WSGI-compatible web servers to serve your project.
# ls # ls -l myfirstdjangoproject
# ls -l myfirstdjangoproject/myfirstdjangoproject
Create Django Project

Create Django Project

In addition, Django has a lightweight built-in web server (written in Python similar to Python SimpleHTTP, what else?) that can be used to test your applications during the development process without having to deal with the task of setting a web server at this particular stage.

However, you need to know that this is not suitable for a production environment – just for development. To launch your newly created project, change your current working directory to the container directory for your project (~/myfirstdjangoenv/myfirstdjangoproject) and run:

# python runserver

If you run into the following error:

You have unapplied migrations; your app may not work properly until they are applied.
Run 'python migrate' to apply them.

Do what it says:

# python migrate

and then start the server again:

# python runserver

We will cover the concept of migrations in the next articles of this series, so you can disregard the error message for the time being.

In any event, you can change the default port where the built-in web server will be listening. By using as the network interface to listen on, we allow other computers in the same network to access the project user interface (if you use instead, you will only be able to access the UI from localhost).

You can also change the port to another one of your choosing, but you’ll also need to make sure that traffic through such port is allowed through your firewall:

# firewall-cmd --add-port=8000/tcp
# firewall-cmd --permanent --add-port=8000/tcp

Of course, it goes without saying that you will need to update the allowed port if you choose to use a different one while launching the lightweight web server.

You should see the following output in your terminal:

# python runserver
Start Django HTTP Server

Start Django HTTP Server

At this point, you can open your favorite web browser and navigate to the IP address of the machine where you installed Django followed by the port number. In my case, it is a Debian Jessie box with IP and listening on port 8000:
Django HTTP Server

Django HTTP Server

While it’s a great thing that we were able to complete the initial setup of a project, there is still much work left to do, as indicated in the message above.


In this guide we have explained how to install and configure a virtual environment for Django, a versatile open source web framework based on Python.

Regardless of whether you are an application developer or a system administrator, you will want to bookmark this article and the rest of this series because chances are that at some point or another you will need to consider the need of such tool for your daily tasks.

In the following articles of this series we will discuss how to build on what we have already accomplished to create a simple, yet functional, web application using Django and Python.

As always, don’t hesitate to drop us a note if you have questions about this article or suggestions to improve. We look forward to hearing from you!

Facebook Comments

More Stuff

It’s a fun time to cook in the smart kitchen – CNET The Brava Oven on display at last week's Smart Kitchen Summit is an example of the type of smart appliance companies are creating for the kitchen. T...
Pro-‘Dota 2’ Players Fend off Elon Musk’s AI Bots—for Now One way to measure progress in artificial intelligence is to chart victories by algorithms over champions of increasingly challenging games—checkers, ...
Top Crypto New from Asia, Podcast is out! — Aug 8th- Aug 11th Binance’s DEX; Bitmain to mine Sia, Dash, $10bn rev in 2018; China accelerate blockchain adoption What Crypto insiders are reading on Asia. Our fourth...
How to Install and Configure Zabbix Agents on Remote Linux Systems... Continuing Zabbix series, this tutorial will guide you on how you can install and configure Zabbix agents on Linux (Debian based systems and CentOS) i...
Spread the love

Posted by News Monkey