{"title":"Como instalar o Django.","version":"2.1","locale":"pt-br","docname":"topics/install","url":"/pt-br/2.1/topics/install/","canonical":"https://djangodocs.dev/pt-br/2.1/topics/install/","summary":"Este documento lhe dirá como instalar e rodar o Django. Instalando Python Link para este cabeçalho # Django is a Python Web framework. See Qual versão do Python eu…","html":"<h1>Como instalar o Django.<a class=\"heading-anchor\" href=\"#how-to-install-django\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>Este documento lhe dirá como instalar e rodar o Django.</p>\n<section id=\"install-python\">\n<h2>Instalando Python<a class=\"heading-anchor\" href=\"#install-python\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Django is a Python Web framework. See <a class=\"reference internal\" href=\"/pt-br/2.1/faq/install/#faq-python-version-support\"><span class=\"std std-ref\">Qual versão do Python eu posso usar com Django?</span></a> for\ndetails.</p>\n<p>Obtenha a última versão do Python em <a class=\"reference external\" href=\"https://www.python.org/downloads/\">https://www.python.org/downloads/</a> ou no gerenciador de pacotes do seu sistema operacional.</p>\n<aside class=\"admonition-django-on-jython admonition\">\n<p class=\"admonition-title\">Django no Jython</p>\n<p><a class=\"reference external\" href=\"http://www.jython.org/\">Jython</a> (a Python implementation for the Java platform) is not compatible\nwith Python 3, so Django ≥ 2.0 cannot run on Jython.</p>\n</aside>\n<aside class=\"admonition-python-on-windows admonition\">\n<p class=\"admonition-title\">Python no Windows</p>\n<p>Se você está apenas começando com o Django e usando Windows, você talvez ache <a class=\"reference internal\" href=\"/pt-br/2.1/howto/windows/\"><span class=\"doc\">Como instalar o Django no Windows</span></a>  útil.</p>\n</aside>\n</section>\n<section id=\"install-apache-and-mod-wsgi\">\n<h2>Instalando o Apache e o <code class=\"docutils literal notranslate\"><span class=\"pre\">mod_wsgi</span></code><a class=\"heading-anchor\" href=\"#install-apache-and-mod-wsgi\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Se você quer apenas experimentar o Django, passe a frente para a próxima seção; o Django inclui um servidor Web leve que você pode usar para testes, aí você não precisa configurar o Apache anté que esteja pronto para implantar o Django em produção.</p>\n<p>If you want to use Django on a production site, use <a class=\"reference external\" href=\"https://httpd.apache.org/\">Apache</a> with\n<a class=\"reference external\" href=\"https://modwsgi.readthedocs.io/en/develop/\">mod_wsgi</a>. mod_wsgi operates in one of two modes: embedded\nmode or daemon mode. In embedded mode, mod_wsgi is similar to\nmod_perl – it embeds Python within Apache and loads Python code into\nmemory when the server starts. Code stays in memory throughout the\nlife of an Apache process, which leads to significant performance\ngains over other server arrangements. In daemon mode, mod_wsgi spawns\nan independent daemon process that handles requests. The daemon\nprocess can run as a different user than the Web server, possibly\nleading to improved security. The daemon process can be restarted\nwithout restarting the entire Apache Web server, possibly making\nrefreshing your codebase more seamless. Consult the mod_wsgi\ndocumentation to determine which mode is right for your setup. Make\nsure you have Apache installed with the mod_wsgi module activated.\nDjango will work with any version of Apache that supports mod_wsgi.</p>\n<p>Veja <a class=\"reference internal\" href=\"/pt-br/2.1/howto/deployment/wsgi/modwsgi/\"><span class=\"doc\">Como usar o Django com mod_wsgi</span></a> para informações de como configurar o mod_wsgi depois de tê-lo instalado.</p>\n<p>Se não pode usar o mod_wsgi por alguma razão, não se preocupe: o Django suporta muitas outras opções para implantação. Uma é <a class=\"reference internal\" href=\"/pt-br/2.1/howto/deployment/wsgi/uwsgi/\"><span class=\"doc\">uWSGI</span></a>; ele trabalha bem com o <a class=\"reference external\" href=\"https://nginx.org/\">nginx</a>. Adina, o Django segue a especificação (<span class=\"target\" id=\"index-2\"></span><a class=\"pep reference external\" href=\"https://peps.python.org/pep-3333/\"><strong>PEP 3333</strong></a>) WSGI, o qual lhe permiti rodar em uma variedade de plataformas de servidores.</p>\n</section>\n<section id=\"get-your-database-running\">\n<span id=\"database-installation\"></span><h2>Tenha seu banco de dados rodando<a class=\"heading-anchor\" href=\"#get-your-database-running\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>Se você planeja usar a funcionalidade de API de banco de dados do Django, terá que assegurar que um servidor de banco de dados está rodando. O Django suporta muitos tipos diferentes de servidores de bancos de dados diferentes, e oficialmente tem suporte para <a class=\"reference external\" href=\"https://www.postgresql.org/\">PostgreSQL</a>, <a class=\"reference external\" href=\"https://www.mysql.com/\">MySQL</a>, <a class=\"reference external\" href=\"https://www.oracle.com/\">Oracle</a> e <a class=\"reference external\" href=\"https://www.sqlite.org/\">SQLite</a>.</p>\n<p>If you are developing a simple project or something you don’t plan to deploy\nin a production environment, SQLite is generally the simplest option as it\ndoesn’t require running a separate server. However, SQLite has many differences\nfrom other databases, so if you are working on something substantial, it’s\nrecommended to develop with the same database that you plan on using in\nproduction.</p>\n<p>Além dos bancos de dados oficialmente suportados, existem <a class=\"reference internal\" href=\"/pt-br/2.1/ref/databases/#third-party-notes\"><span class=\"std std-ref\">“backends” fornecidos por terceiros</span></a> que permitem que você use outros bancos de dados com o Django.</p>\n<p>Além do “backend” do banco de dados, você precisa assegurar que seus “bindings” para Python para o banco de dados estão instalados.</p>\n<ul class=\"simple\">\n<li><p>Se você estiver usando o PostgreSQL, você precisa do pacote <a class=\"reference external\" href=\"http://initd.org/psycopg/\">psycopg2</a>. Veja as <a class=\"reference internal\" href=\"/pt-br/2.1/ref/databases/#postgresql-notes\"><span class=\"std std-ref\">Notas sobre PostgreSQL</span></a> para maiores detalhes.</p></li>\n<li><p>Se você está usando MySQL, você irá precisar um <a class=\"reference internal\" href=\"/pt-br/2.1/ref/databases/#mysql-db-api-drivers\"><span class=\"std std-ref\">Driver para DB API</span></a> como <code class=\"docutils literal notranslate\"><span class=\"pre\">mysqlclient</span></code>. Veja <a class=\"reference internal\" href=\"/pt-br/2.1/ref/databases/#mysql-notes\"><span class=\"std std-ref\">notas para o Backend do MySQL</span></a> para detalhes.</p></li>\n<li><p>Se você estiver usando SQLite você talvez queira ler as <a class=\"reference internal\" href=\"/pt-br/2.1/ref/databases/#sqlite-notes\"><span class=\"std std-ref\">Notas para o Backend do SQLite</span></a>.</p></li>\n<li><p>Se você estiver usando Oracle, você irá precisar de uma cópia do <a class=\"reference external\" href=\"https://oracle.github.io/python-cx_Oracle/\">cx_Oracle</a>, mas por favor leia as <a class=\"reference internal\" href=\"/pt-br/2.1/ref/databases/#oracle-notes\"><span class=\"std std-ref\">notas para o Backend do Oracle</span></a> para detalhes sobre versões suportadas para ambos o Oracle e o <code class=\"docutils literal notranslate\"><span class=\"pre\">cx_Oracle</span></code>.</p></li>\n<li><p>Se você estiver usando um “backend” não oficial de terceiros, por favor consulte a documentação fornecida para qualquer requerimento adicional.</p></li>\n</ul>\n<p>Se você planeja usar o comando <code class=\"docutils literal notranslate\"><span class=\"pre\">manage.py</span> <span class=\"pre\">migrate</span></code> do Django para automaticamente criar as tabelas do banco de dados para seus modelos (depois de primeiro instalar o Django e criar um projeto), você precisa se assegurar que o Django tem permissão para criar e alterar tabelas no banco de dados que estiver usando; Se você planeja criar manualmente as tabelas, você pode simplesmente dar permissões de <code class=\"docutils literal notranslate\"><span class=\"pre\">SELECT</span></code>, <code class=\"docutils literal notranslate\"><span class=\"pre\">INSERT</span></code>, <code class=\"docutils literal notranslate\"><span class=\"pre\">UPDATE</span></code> and <code class=\"docutils literal notranslate\"><span class=\"pre\">DELETE</span></code> ao Django. Depois de criar um usuário do banco de dados com estas permissões, você irá especificar os detalhes no arquivo de configuração do seu projeto, veja <a class=\"reference internal\" href=\"/pt-br/2.1/ref/settings/#std-setting-DATABASES\"><code class=\"xref std std-setting docutils literal notranslate\"><span class=\"pre\">DATABASES</span></code></a> para detalhes.</p>\n<p>Se você está usando o <a class=\"reference internal\" href=\"/pt-br/2.1/topics/testing/\"><span class=\"doc\">framework de testes</span></a> do Django para testar consultas no banco de dados, o Django irá precisar de permissão para criar o banco de dados de teste.</p>\n</section>\n<section id=\"install-the-django-code\">\n<span id=\"install-django-code\"></span><h2>Instalando o código do Django.<a class=\"heading-anchor\" href=\"#install-the-django-code\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>As instruções de instalação são um pouco diferentes dependendo de se você está instalando um pacote de uma distribuição específica, fazendo o download da última versão oficial, ou pegando a última versão em desenvolvimento.</p>\n<p>É fácil, não importa a maneira que você escolheu.</p>\n<section id=\"installing-an-official-release-with-pip\">\n<span id=\"installing-official-release\"></span><h3>Instalando uma versão oficial com <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code><a class=\"heading-anchor\" href=\"#installing-an-official-release-with-pip\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Este é o modo recomendável de instalar o Django.</p>\n<ol class=\"arabic\">\n<li><p>Instale o <a class=\"reference external\" href=\"https://pip.pypa.io/\">pip</a>. A maneira mais fácil é usar o <a class=\"reference external\" href=\"https://pip.pypa.io/en/latest/installing/#installing-with-get-pip-py\">standalone pip installer</a>. Se sua distribuição já tem o <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code> instalado, você talvez precisa atualizá-lo se estiver desatualizado, você saberá porque a instalação não irá funcionar.</p></li>\n<li><p>Take a look at <a class=\"reference external\" href=\"https://virtualenv.pypa.io/\">virtualenv</a> and <a class=\"reference external\" href=\"https://virtualenvwrapper.readthedocs.io/en/latest/\">virtualenvwrapper</a>. These tools provide\nisolated Python environments, which are more practical than installing\npackages systemwide. They also allow installing packages without\nadministrator privileges. The <a class=\"reference internal\" href=\"/pt-br/2.1/intro/contributing/\"><span class=\"doc\">contributing tutorial</span></a> walks through how to create a virtualenv.</p></li>\n<li><p>After you’ve created and activated a virtual environment, enter the command:</p>\n<div class=\"console\" data-console><div class=\"console-panel\" data-platform=\"unix\"><p class=\"console-label\" id=\"console-0-unix-label\">Linux / macOS</p><div class=\"code-block\" data-language=\"console\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</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=\"Shell code\"><code><span class=\"gp\">$ </span>pip<span class=\"w\"> </span>install<span class=\"w\"> </span>Django\n</code></pre></div>\n</div><div class=\"console-panel\" data-platform=\"windows\"><p class=\"console-label\" id=\"console-0-windows-label\">Windows</p><div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</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=\"Windows shell\"><code><span class=\"gp\">...\\&gt;</span> pip install Django\n</code></pre></div></div></div>\n</li>\n</ol>\n</section>\n<section id=\"installing-a-distribution-specific-package\">\n<span id=\"installing-distribution-package\"></span><h3>Instalando um pacote de uma distribuição específica.<a class=\"heading-anchor\" href=\"#installing-a-distribution-specific-package\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h3>\n<p>Verifique as <a class=\"reference internal\" href=\"/pt-br/2.1/misc/distributions/\"><span class=\"doc\">notas específicas de distribuições</span></a> para ver se sua plataforma/distribuição fornecem pacotes/instaladores oficiais do Django. Pacotes fornecidos por distribuições tipicamente irão permitir uma instalação automática de dependências e facilmente atualizar os “paths”; contudo, estes pacotes raramente irão conter a última versão do Django.</p>\n</section>\n<section id=\"installing-the-development-version\">\n<span id=\"installing-development-version\"></span><h3>Instalando a versão de desenvolvimento.<a class=\"heading-anchor\" href=\"#installing-the-development-version\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h3>\n<aside class=\"admonition-tracking-django-development admonition\">\n<p class=\"admonition-title\">Acompanhando o desenvolvimento do Django.</p>\n<p>Se você decidir usar a última versão de desenvolvimento do Django, você precisará acompanhar de perto o <a class=\"reference external\" href=\"https://code.djangoproject.com/timeline\">the development timeline</a>, e irá querer manter um olho no <a class=\"reference internal\" href=\"/pt-br/2.1/releases/#development-release-notes\"><span class=\"std std-ref\">notas de desenvolvimento para o próximo lançamento</span></a>. Isso lhe ajudará a se manter no topo de qualquer nova funcionalidade que você talvez queira usar, assim como qualquer mudança que você precise fazer no seu código quando atualizar sua cópia do Django. (Para lançamentos estabilizados, qualquer mudança necessária é documentada nas notas de lançamento.)</p>\n</aside>\n<p>Se você quiser ser capaz de ocasionalmenete atualizar o seu código Django com as últimas correções e melhorias, siga estas instruções:</p>\n<ol class=\"arabic\">\n<li><p>Assegure-se que tenha instalado o <a class=\"reference external\" href=\"https://git-scm.com/\">Git</a> e que você pode executar seus comandos no seu shell. (Digite <code class=\"docutils literal notranslate\"><span class=\"pre\">git</span> <span class=\"pre\">help</span></code> no “prompt” do seu shell para testar.)</p></li>\n<li><p>Pegue o pricipal ramo de desenvolvimento do Django como aqui:</p>\n<div class=\"console\" data-console><div class=\"console-panel\" data-platform=\"unix\"><p class=\"console-label\" id=\"console-1-unix-label\">Linux / macOS</p><div class=\"code-block\" data-language=\"console\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</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=\"Shell code\"><code><span class=\"gp\">$ </span>git<span class=\"w\"> </span>clone<span class=\"w\"> </span>https://github.com/django/django.git\n</code></pre></div>\n</div><div class=\"console-panel\" data-platform=\"windows\"><p class=\"console-label\" id=\"console-1-windows-label\">Windows</p><div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</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=\"Windows shell\"><code><span class=\"gp\">...\\&gt;</span> git clone https://github.com/django/django.git\n</code></pre></div></div></div>\n<p>Isso irá criar um diretório <code class=\"docutils literal notranslate\"><span class=\"pre\">django</span></code> no seu diretório corrente.</p>\n</li>\n<li><p>Make sure that the Python interpreter can load Django’s code. The most\nconvenient way to do this is to use <a class=\"reference external\" href=\"https://virtualenv.pypa.io/\">virtualenv</a>, <a class=\"reference external\" href=\"https://virtualenvwrapper.readthedocs.io/en/latest/\">virtualenvwrapper</a>, and\n<a class=\"reference external\" href=\"https://pip.pypa.io/\">pip</a>. The <a class=\"reference internal\" href=\"/pt-br/2.1/intro/contributing/\"><span class=\"doc\">contributing tutorial</span></a> walks through\nhow to create a virtualenv.</p></li>\n<li><p>Depois de configurar e ativar o virtualenv, rode o seguinte comando:</p>\n<div class=\"console\" data-console><div class=\"console-panel\" data-platform=\"unix\"><p class=\"console-label\" id=\"console-2-unix-label\">Linux / macOS</p><div class=\"code-block\" data-language=\"console\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Shell</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=\"Shell code\"><code><span class=\"gp\">$ </span>pip<span class=\"w\"> </span>install<span class=\"w\"> </span>-e<span class=\"w\"> </span>django/\n</code></pre></div>\n</div><div class=\"console-panel\" data-platform=\"windows\"><p class=\"console-label\" id=\"console-2-windows-label\">Windows</p><div class=\"code-block\" data-language=\"doscon\"><div class=\"code-block-toolbar\"><span class=\"code-block-language\">Windows</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=\"Windows shell\"><code><span class=\"gp\">...\\&gt;</span> pip install -e django\\\n</code></pre></div></div></div>\n<p>Isso fará com que o código do Django seja passível de importação, e fará co que o comando utilitário <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span></code> esteja disponível. Em outras palavras, você está pronto.</p>\n</li>\n</ol>\n<p>Quando quiser atualizar sua cópia do código fonte do Django, apenas rode o comando <code class=\"docutils literal notranslate\"><span class=\"pre\">git</span> <span class=\"pre\">pull</span></code> de dentro do diretório do Django. Quando fizer isso, o Git automaticamente irá baixar qualquer mudança.</p>\n</section>\n</section>","rootId":"how-to-install-django","toc":[{"title":"Instalando Python","anchor":"install-python","children":[]},{"title":"Instalando o Apache e o mod_wsgi","anchor":"install-apache-and-mod-wsgi","children":[]},{"title":"Tenha seu banco de dados rodando","anchor":"get-your-database-running","children":[]},{"title":"Instalando o código do Django.","anchor":"install-the-django-code","children":[{"title":"Instalando uma versão oficial com pip","anchor":"installing-an-official-release-with-pip","children":[]},{"title":"Instalando um pacote de uma distribuição específica.","anchor":"installing-a-distribution-specific-package","children":[]},{"title":"Instalando a versão de desenvolvimento.","anchor":"installing-the-development-version","children":[]}]}],"breadcrumbs":[{"docname":"topics/index","title":"Usando o Django","url":"/pt-br/2.1/topics/"}],"prev":{"docname":"topics/index","title":"Usando o Django","url":"/pt-br/2.1/topics/"},"next":{"docname":"topics/db/index","title":"Modelos e bancos de dados","url":"/pt-br/2.1/topics/db/"},"formats":{"html":"/pt-br/2.1/topics/install/","markdown":"/pt-br/2.1/topics/install.md","json":"/pt-br/2.1/topics/install.json"},"source":"https://github.com/django/django/blob/stable/2.1.x/docs/topics/install.txt","official":"https://docs.djangoproject.com/pt-br/2.1/topics/install/","inVersions":["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"],"inLocales":["en","zh-hans","fr","ja","id","pt-br","ko","es","el","pl"]}