How to Install Django on Ubuntu 20.04 LTS
This tutorial exists for these OS versions
- Ubuntu 22.04 (Jammy Jellyfish)
- Ubuntu 20.04 (Focal Fossa)
- Ubuntu 18.04 (Bionic Beaver)
- Ubuntu 16.04 (Xenial Xerus)
- Ubuntu 15.04 (Vivid Vervet)
On this page
Django is a web application framework written in python that follows the MVC (Model-View-Controller) architecture, it is available for free and released under an open-source license. It is fast and designed to help developers get their applications online as quickly as possible. Django helps developers to avoid many common security mistakes like SQL Injection, XSS, CSRF, and clickjacking.
Django is maintained by the Django Software Foundation and used by many big technology companies, governments, and other organizations. Some large websites like Pinterest, Mozilla, Instagram, Discuss, The Washington Post, etc. are developed with Django.
In this tutorial, we will show you how to install Django 3.0 on the latest Ubuntu 20.04 server. we will install Django with Python 3 (as default version on Ubuntu 20.04), and we will show you 4 different ways to install Django Framework, install through the Apt repository, pip, and using the Python Virtualenv.
What we will do?
- Setup Python and Pip
- Install Django Framework
- Create Your First Project with Django
Step 1 - Setup Python and Pip
In this first step, we will set up Python and Pip on the Ubuntu 20.04 system.
By default, the Ubuntu 20.04 cames with the Python 3 as default python version. it's available as a 'python3' command, not a 'python'.
Check the python command as below.
You will get the 'python' command is not found.
Command 'python' not found, did you mean:
command 'python3' from deb python3
command 'python' from deb python-is-python3
To solve this, make a symbolic link of the Python3 binary '/usr/bin/python3' to '/usr/bin/python' as default python command using the following command.
update-alternatives --install /usr/bin/python python /usr/bin/python3 1
Now check the python command as below.
And you will get the following response.
The configuration of Python3 has bee completed.
Next, we will install the package manager for python packages 'python3-pip'.
Install python3-pip using the apt command below.
sudo apt install python3-pip -y
Once all installation is completed, make the 'pip3' command as default 'pip' version.
update-alternatives --install /usr/bin/pip pip /usr/bin/pip3 1
After that, check the pip command below.
Below is the result you will get.
pip 20.0.2 from /usr/lib/python3/dist-packages/pip (python 3.8)
As a result, the installation of the Python package manager (pip) has been completed.
Step 2 - Install Django Framework
After installing and configure Python and Pip, we will install the Django Framework on our system. Thre are 4 different to install the Python Django Framework, install using the Apt repository, using pip command, using the virtualenv, or using the Django git version.
Install Django with Apt
By default, the Ubuntu 20.04 repository provides packages for Django Framework named 'python3-django'. At this time (tutorial writing), the Ubuntu repository provides the Django 2.2.12, which is not the latest stable version of Django.
Check the 'python3-django' package using the apt command below.
apt show python3-django
And you will get details about the 'python3-django' package.
To install the package, run the apt command below.
apt install python3-django
Once all installation is completed, check the Django version using the following.
You will get the following result.
As a result, Django 2.12 is installed on the ubuntu 20.04 through the official Ubuntu repository.
Install Django with PIP
The main advantage of installing the Django Framework with the pip command through the PyPI repository is that you can choose the right version of Django for your project.
For this section, we will install the Django 3.0 (latest stable version) from the PyPi repository.
Install Django framework 3.0 using the pip command below.
pip install django==3.0.0
Once all installation is completed, check the Django version using the following command.
And you will get the Django version 3.0 as the response.
optionally, you can check through the Python interactive shell, run the python command below.
Import the Django module and show the Django version using the following query.
You will get the Django 3.0 response as below.
As a result, you've successfully installed the Django 3.0 using the PyPi repository.
Install Django with Virtualenv
This is the most recommended practice for installing Django Framework, by using the python Virtualenv. It's a python environment builder that can be used to create isolated python environments.
You can choose the Python version that will be installed in the virtual environment, and all installation in the Python virtual environment will not affect the system. This is very useful for developers, they can run and develop an application with different python versions and different environments on one OS.
First, install the Python virtualenv packages from the PyPi repository using the pip command below.
pip install virtualenv
Once all installation is completed, create a new Python virtual environment 'myenv' using the following command.
Now go to the 'myenv' directory and activate the virtual environment using the command as below.
After that, install the Python Django Framework using the pip command below.
pip install django==3.0.0
And the Python Django Framework is now installed on the Python virtual environment. Check the Django version using the following command.
You will get the Django 3.0 as the response, and the Django Framework is installed on the Python virtual environment.
To back to the normal user and deactivate the virtual environment, run the command.
Now you will be switched back to the normal user environment of your system.
Install Django from Git Repository
This method is recommended if you want to install the development version of Django Framework.
First, install the git packages using the apt command below.
apt install git
Next, create a new virtual environment named 'django-git' using the virtualenv command below.
Go to the 'django-git' directory and activate the virtual environment.
Clone the latest Django version from the official Django GitHub repository and install the Django development version using the pip command as below.
git clone git://github.com/django/django django-dev
pip install -e django-dev
Once all installation is completed, check the Django version.
And you will get the latest version of the Django Framework development version.
Now you've learned how to install Python Django using multiple ways.
Step 3 - Create Your First Project with Python Django
After installing the Django project, we will show you how to start a new project with the Python Django framework.
Create a new virtual environment 'myproject'.
Go to the 'myproject' directory and activate the virtual environment.
After that, install the Django 3.0 using the pip command as below.
pip install django==3.0.0
Now you've installed the Django Framework.
Create a Django project named 'mysite' using the 'django-admin' command as below.
django-admin startproject mysite
Now you will get a new directory named 'mysite' which contains all Djaango configuration.
Go to the 'mysite' directory and check all files configuration.
cd mysite/; tree
Below is the result you will get.
Next, edit the configuration 'settings.py' inside the 'mysite' django directory.
On the 'ALLOWED_HOSTS' configuration, input your IP address as below.
ALLOWED_HOSTS = ["your-server-ip"]
Save and close.
Next, we will migrate the database for our Django project. By default, the Django framework used the SQLite database.
Migrate the Django database using the following command.
python manage.py migrate
After that, create a new admin user for your Django project.
python manage.py createsuperuser
Now type your username, email address, and the password, then press enter.
As a result, the default database SQLite for the Django project has been migrated, and the admin user has been created.
Step 4 - Start the Python Django Project
After migrating the database of the Django project, we will run the Django project.
Run the Python Django runserver command below.
python manage.py runserver 0.0.0.0:8000
As a result, your Django project is now up and running on port '8000'.
Open your web browser and type the server IP address with port '8000' on the address bar.
And you will get the default Django home page.
Next, add the 'admin' path on the address bar and you will get the Django admin login page.
Type your username and password, then click the 'Login' button.
And you will get the default Django admin dashboard as below.
As a result, the installation of the Django Framework with Python 3 on Ubuntu 20.04 has been completed successfully.