= Third-party distributions of Django =

Many third-party distributors are now providing versions of Django integrated with their package-management systems. These can make installation and upgrading much easier for users of Django since the integration includes the ability to automatically install dependencies (like database adapters) that Django requires.

Typically, these packages are based on the latest stable release of Django, so if you want to use the development version of Django you’ll need to follow the instructions for installing the development version from our Subversion repository.

== Windows, Linux and Mac OS X ==

The [http://bitnami.org/stack/djangostack BitNami Django Stack] is a free distribution which includes ready-to-run versions of Apache, MySQL, PostgreSQL, SQLite, Python, Django and required dependencies. It can be deployed using a native installer, as a virtual machine or in the cloud.

== Linux distributions ==

=== Archlinux ===

Install python-django or python2-django, for Python 3 or Python 2 support respectively, from the Official Repositories.

Installed using the following command with root privileges
`pacman -S python2-django`

=== Debian ===

The Debian package is named python-django and can be installed using the following command with root privileges.

{{{aptitude install python-django}}}

[http://packages.debian.org/search?searchon=names&keywords=python-django all Debian releases], see [http://www.debian.org/doc/manuals/reference/ch-package.en.html#s-aptitude Debian Reference • Chapter 6] [http://www.debian.org/doc/manuals/reference/ch-package.en.html – Debian package management] for instructions 

=== Fedora ===

[https://apps.fedoraproject.org/packages/python-django Package]

=== Gentoo ===

[https://packages.gentoo.org/packages/dev-python/django Package]

=== openSUSE ===

A Django package is available for [http://www.opensuse.org/ openSUSE Linux] in the [http://build.opensuse.org/ openSUSE Build Service]. The current package can be installed by subscribing to the [http://download.opensuse.org/repositories/devel:/languages:/python/ devel:languages:python project]
and typing 'zypper install python-django'. Alternatively, you can use a [http://software.opensuse.org/search?q=python-django one-click-install link].

=== RPM Based Distributions === 

[http://rpmfind.net/linux/rpm2html/search.php?query=django from rpmfind.net]

=== SELinux ===

While the Django documentation recommends starting a Django project outside of the web server's document root (e.g. '''/var/www'''), SELinux does not allow web servers such as Apache access outside of their document roots.  See also: [http://www.packtpub.com/article/selinux-secured-web-hosting-python-based-web-applications SELinux - Highly Secured Web Hosting for Python-based Web Applications].

=== Ubuntu ===

[http://packages.ubuntu.com/search?searchon=names&keywords=python-django all Ubuntu releases], see also [https://help.ubuntu.com/ Ubuntu documentation] on "Adding and Removing Software"

== UNIX distributions ==

=== FreeBSD ===

There are two options:

 * To add the package: `pkg install py-django`
 * To install the port: `cd /usr/ports/www/py-django/ && make install clean`

For recent changes [http://www.freshports.org/www/py-django/]

=== NetBSD ===

There are two options:

 * To add the binary package: `pkg_add py27-django`
 * To install the package from source: `cd /usr/pkgsrc/www/py-django/ && make install clean`

For recent changes [http://pkgsrc.se/www/py-django/]

=== Mac OS X ===

==== MacPorts ====

Django 1.11.7 can be installed via the MacPorts system:

 * '''Python 2.7''': `sudo port install py27-django`
 * '''Python 3.5''': `sudo port install py35-django`
 * '''Python 3.6''': `sudo port install py36-django`

Please note that `django-admin.py` is renamed according to the Python 
version you installed it for (`django-admin-2.5.py` if you 
installed py25-django).

To enable bash completion install the `bash_completion` variant (`sudo port install py25-django +bash_completion`).

To avoid a command not found issue with Snow Leopard 10.6.2 and various other OSX (Django installed using MacPorts) here a tip that might help. There might be a $PATH issue. Adding the proper PATH to ~/.Profile: export PATH=/opt/local/bin:opt/local/sbin:/opt/local/lib/python2.4/site-packages/django/bin:$PATH should help. NB Could be that one needs to change the Python version in the PATH.

You can also change the PATH at the system level by creating the file
{{{
/etc/paths.d/macports
}}}
with the contents
{{{
/opt/local/bin
/opt/local/sbin
/opt/local/lib/python2.4/site-packages/django/bin
}}}
Be sure to change the last path to reflect the version of Python on your system. 

==== Rudix ====

The [http://rudix.org Rudix] package system for OS X has ready to download DMG files, containing a standard PKG installer. Rudix takes care to play nicely with the default Python installation. Admin utils and documentation will go to /usr/local.

=== OpenBSD ===

There are two options:

 * Install as package: `pkg_add py-django`
 * Installation over ports system: `cd /usr/ports/www/py-django; sudo make; sudo make install`

For recent changes [http://openports.se/www/py-django]