Quick install guide¶
Before you can use Django, you’ll need to get it installed. We have a complete installation guide that covers all the possibilities; this guide will guide you to a simple, minimal installation that’ll work while you walk through the introduction.
Being a Python Web framework, Django requires Python. It works with Python 2.7, 3.2, 3.3, or 3.4. All these versions of Python include a lightweight database called SQLite so you won’t need to set up a database just yet.
Get the latest version of Python at http://www.python.org/download/ or with your operating system’s package manager.
Django on Jython
You can verify that Python is installed by typing python from your shell; you should see something like:
Python 3.3.3 (default, Nov 26 2013, 13:33:18) [GCC 4.8.2] 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 engine like PostgreSQL, MySQL, or Oracle. To install such a database, consult the database installation information.
Remove any old versions of Django¶
If you are upgrading your installation of Django from a previous version, you will need to uninstall the old Django version before installing the new version.
You’ve got three easy options to install Django:
- Install a version of Django provided by your operating system distribution. This is the quickest option for those who have operating systems that distribute Django.
- Install an official release. This is the best approach for users who want a stable version number and aren’t concerned about running a slightly older version of Django.
- Install the latest development version. This is best for users who want the latest-and-greatest features and aren’t afraid of running brand-new code.
Always refer to the documentation that corresponds to the version of Django you’re using!
If you do either of the first two steps, keep an eye out for parts of the documentation marked new in development version. That phrase flags features that are only available in development versions of Django, and they likely won’t work with an official release.
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()) 1.8
You may have another version of Django installed.
Having trouble? We'd like to help!
- Try the FAQ — it's got answers to many common questions.
- Search for information in the archives of the django-users mailing list, or post a question.
- Ask a question in the #django IRC channel, or search the IRC logs to see if it has been asked before.
- If you notice errors with this documentation, please open a ticket and let us know! Please only use the ticket tracker for criticisms and improvements on the docs. For tech support, use the resources above.