Quick install guide

Before you can use Django, you’ll need to get it installed. We have acomplete installation guide that covers all thepossibilities; this guide will guide you to a minimal installation that’ll workwhile you walk through the introduction.

Install Python

Being a Python Web framework, Django requires Python. SeeWhat Python version can I use with Django? for details. Python includes a lightweightdatabase called SQLite so you won’t need to set up a database just yet.

Get the latest version of Python at https://www.python.org/downloads/ or withyour operating system’s package manager.

You can verify that Python is installed by typing python from your shell;you should see something like:

Python 3.x.y
[GCC 4.x] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>>

Set up a database

This step is only necessary if you’d like to work with a “large” database enginelike PostgreSQL, MariaDB, MySQL, or Oracle. To install such a database, consultthe database installation information.

Install Django

You’ve got three options to install Django:

• Install an official release. Thisis the best approach for most users.
• Install a version of Django provided by your operating systemdistribution.
• Install the latest development version. This option is for enthusiasts who wantthe latest-and-greatest features and aren’t afraid of running brand new code.You might encounter new bugs in the development version, but reporting themhelps the development of Django. Also, releases of third-party packages areless likely to be compatible with the development version than with thelatest stable release.

Always refer to the documentation that corresponds to theversion of Django you’re using!

If you do either of the first two steps, keep an eye out for parts of thedocumentation marked new in development version. That phrase flagsfeatures that are only available in development versions of Django, andthey likely won’t work with an official release.

Verifying

To verify that Django can be seen by Python, type python from your shell.Then at the Python prompt, try to import Django:

>>> import django
>>> print(django.get_version())
3.0

You may have another version of Django installed.

That’s it!

That’s it – you can now move onto the tutorial.