{"title":"Quick install guide","version":"1.10","locale":"en","docname":"intro/install","url":"/en/1.10/intro/install/","canonical":"https://djangodocs.dev/en/1.10/intro/install/","summary":"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…","html":"<h1>Quick install guide<a class=\"heading-anchor\" href=\"#quick-install-guide\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Before you can use Django, you’ll need to get it installed. We have a\n<a class=\"reference internal\" href=\"/en/1.10/topics/install/\"><span class=\"doc\">complete installation guide</span></a> that covers all the\npossibilities; this guide will guide you to a simple, minimal installation\nthat’ll work while you walk through the introduction.</p>\n<section id=\"install-python\">\n<h2>Install Python<a class=\"heading-anchor\" href=\"#install-python\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Being a Python Web framework, Django requires Python. See\n<a class=\"reference internal\" href=\"/en/1.10/faq/install/#faq-python-version-support\"><span class=\"std std-ref\">What Python version can I use with Django?</span></a> for details. Python includes a lightweight\ndatabase called <a class=\"reference external\" href=\"https://sqlite.org/\">SQLite</a> so you won’t need to set up a database just yet.</p>\n<p>Get the latest version of Python at <a class=\"reference external\" href=\"https://www.python.org/download/\">https://www.python.org/download/</a> or with\nyour operating system’s package manager.</p>\n<aside class=\"admonition-django-on-jython admonition\">\n<p class=\"admonition-title\">Django on Jython</p>\n<p>If you use <a class=\"reference external\" href=\"http://www.jython.org/\">Jython</a> (a Python implementation for the Java platform), you’ll\nneed to follow a few additional steps. See <a class=\"reference internal\" href=\"/en/1.10/howto/jython/\"><span class=\"doc\">Running Django on Jython</span></a> for details.</p>\n</aside>\n<p>You can verify that Python is installed by typing <code class=\"docutils literal notranslate\"><span class=\"pre\">python</span></code> from your shell;\nyou should see something like:</p>\n<div class=\"code-block\" data-language=\"default\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Code</span><button type=\"button\" class=\"copy-button\" data-copy hidden><span class=\"copy-button-label\">Copy</span></button></div><pre role=\"group\" tabindex=\"0\" aria-label=\"Code code\"><code><span class=\"n\">Python</span> <span class=\"mf\">3.4</span><span class=\"o\">.</span><span class=\"n\">x</span>\n<span class=\"p\">[</span><span class=\"n\">GCC</span> <span class=\"mf\">4.</span><span class=\"n\">x</span><span class=\"p\">]</span> <span class=\"n\">on</span> <span class=\"n\">linux</span>\n<span class=\"n\">Type</span> <span class=\"s2\">&quot;help&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;copyright&quot;</span><span class=\"p\">,</span> <span class=\"s2\">&quot;credits&quot;</span> <span class=\"ow\">or</span> <span class=\"s2\">&quot;license&quot;</span> <span class=\"k\">for</span> <span class=\"n\">more</span> <span class=\"n\">information</span><span class=\"o\">.</span>\n<span class=\"o\">&gt;&gt;&gt;</span>\n</code></pre></div>\n</section>\n<section id=\"set-up-a-database\">\n<h2>Set up a database<a class=\"heading-anchor\" href=\"#set-up-a-database\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>This step is only necessary if you’d like to work with a “large” database engine\nlike PostgreSQL, MySQL, or Oracle. To install such a database, consult the\n<a class=\"reference internal\" href=\"/en/1.10/topics/install/#database-installation\"><span class=\"std std-ref\">database installation information</span></a>.</p>\n</section>\n<section id=\"remove-any-old-versions-of-django\">\n<h2>Remove any old versions of Django<a class=\"heading-anchor\" href=\"#remove-any-old-versions-of-django\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>If you are upgrading your installation of Django from a previous version, you\nwill need to <a class=\"reference internal\" href=\"/en/1.10/topics/install/#removing-old-versions-of-django\"><span class=\"std std-ref\">uninstall the old Django version before installing the new\nversion</span></a>.</p>\n</section>\n<section id=\"install-django\">\n<h2>Install Django<a class=\"heading-anchor\" href=\"#install-django\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>You’ve got three easy options to install Django:</p>\n<ul class=\"simple\">\n<li><p><a class=\"reference internal\" href=\"/en/1.10/topics/install/#installing-official-release\"><span class=\"std std-ref\">Install an official release</span></a>. This\nis the best approach for most users.</p></li>\n<li><p>Install a version of Django <a class=\"reference internal\" href=\"/en/1.10/topics/install/#installing-distribution-package\"><span class=\"std std-ref\">provided by your operating system\ndistribution</span></a>.</p></li>\n<li><p><a class=\"reference internal\" href=\"/en/1.10/topics/install/#installing-development-version\"><span class=\"std std-ref\">Install the latest development version</span></a>. This option is for enthusiasts who want\nthe latest-and-greatest features and aren’t afraid of running brand new code.\nYou might encounter new bugs in the development version, but reporting them\nhelps the development of Django. Also, releases of third-party packages are\nless likely to be compatible with the development version than with the\nlatest stable release.</p></li>\n</ul>\n<aside class=\"admonition-always-refer-to-the-documentation-that-corresponds-to-the-version-of-django-you-re-using admonition\">\n<p class=\"admonition-title\">Always refer to the documentation that corresponds to the\nversion of Django you’re using!</p>\n<p>If you do either of the first two steps, keep an eye out for parts of the\ndocumentation marked <strong>new in development version</strong>. That phrase flags\nfeatures that are only available in development versions of Django, and\nthey likely won’t work with an official release.</p>\n</aside>\n</section>\n<section id=\"verifying\">\n<h2>Verifying<a class=\"heading-anchor\" href=\"#verifying\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>To verify that Django can be seen by Python, type <code class=\"docutils literal notranslate\"><span class=\"pre\">python</span></code> from your shell.\nThen at the Python prompt, try to import Django:</p>\n<pre class=\"literal-block\">&gt;&gt;&gt; import django\n&gt;&gt;&gt; print(django.get_version())\n1.10</pre>\n<p>You may have another version of Django installed.</p>\n</section>\n<section id=\"that-s-it\">\n<h2>That’s it!<a class=\"heading-anchor\" href=\"#that-s-it\"><span class=\"visually-hidden\">Link to this heading</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>That’s it – you can now <a class=\"reference internal\" href=\"/en/1.10/intro/tutorial01/\"><span class=\"doc\">move onto the tutorial</span></a>.</p>\n</section>","rootId":"quick-install-guide","toc":[{"title":"Install Python","anchor":"install-python","children":[]},{"title":"Set up a database","anchor":"set-up-a-database","children":[]},{"title":"Remove any old versions of Django","anchor":"remove-any-old-versions-of-django","children":[]},{"title":"Install Django","anchor":"install-django","children":[]},{"title":"Verifying","anchor":"verifying","children":[]},{"title":"That’s it!","anchor":"that-s-it","children":[]}],"breadcrumbs":[{"docname":"intro/index","title":"Getting started","url":"/en/1.10/intro/"}],"prev":{"docname":"intro/overview","title":"Django at a glance","url":"/en/1.10/intro/overview/"},"next":{"docname":"intro/tutorial01","title":"Writing your first Django app, part 1","url":"/en/1.10/intro/tutorial01/"},"formats":{"html":"/en/1.10/intro/install/","markdown":"/en/1.10/intro/install.md","json":"/en/1.10/intro/install.json"},"source":"https://github.com/django/django/blob/stable/1.10.x/docs/intro/install.txt","official":"https://docs.djangoproject.com/en/1.10/intro/install/","inVersions":["dev","6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11","1.10","1.9","1.8"],"inLocales":["en","fr","ja","id","pt-br","es","el","pl"]}