--- title: "Como instalar o Django." version: 1.9 locale: pt-br source: https://docs.djangoproject.com/pt-br/1.9/topics/install/ canonical: https://djangodocs.dev/pt-br/1.9/topics/install/ --- # Como instalar o Django. Este documento lhe dará como instalar e rodar o Django. ## Instalando Python Sendo um framework Web Python, Django requer Python. Veja [Qual versão do Python eu posso usar com Django?](/pt-br/1.9/faq/install/#faq-python-version-support) para detalhes. Baixe a ultima versão do Python em ou no gerenciador de pacote do seu sistema operacional. > **Django no Jython** > > Se você usa o [Jython](http://jython.org/) (uma implementação do Python para a plataforma Java), você precisa seguir alguns passos adicionais. Para maiores informações veja [Rodando o Django no Jython](/pt-br/1.9/howto/jython/). > **Python no Windows** > > Se você está apenas começando com o Django e usando Windows, você talvez ache [Como instalar o Django no Windows](/pt-br/1.9/howto/windows/) útil. ## Instalando o Apache e o `mod_wsgi` 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. Se você quer usar o Django em um site em produção, use o [Apache](https://httpd.apache.org/) com [mod\_wsgi](http://www.modwsgi.org/). O mod\_wsgi pode operar em um dos dois modos: um modo embutido e um modo de “deamon”. No modo embutido, mod\_wsgi é similar ao mod\_perl – ele embuti Python dentro do Apache e carrega o código Python na memória quando o servidor inicia. O código permanece na memória durante a vida do processo Apache, o que leva a significativos ganhos de performance se comparado com outros arranjos de servidores. No modo “deamon”, mod\_wsgi desova um processo “deamon” independente que lida com as requisições. O processo “deamon” pode rodar com um usuário diferente do usuário do servidor Web, possivelmente levando a uma melhora de segurança, e o processo “deamon” pode ser reiniciado sem ter que reiniciar todo o servidor web Apache, possivelmente fazendo com que o a atualização do seu código seja menos penoso.Consulte a documentação do mod\_wsgi para determinar qual modo é correto para sua instalação. Assegure-se de ter o Apache instalado, com o módulo mod\_wsgi ativado. O Django irá trabahar com qualquer versao do Apache que de suporte a mod\_wsgi. Veja [Como usar o Django com mod\_wsgi](/pt-br/1.9/howto/deployment/wsgi/modwsgi/) para informações de como configurar o mod\_wsgi depois de tê-lo instalado. 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 é [uWSGI](/pt-br/1.9/howto/deployment/wsgi/uwsgi/); ele trabalha bem com o [nginx](http://nginx.org/). Adina, o Django segue a especificação ([**PEP 3333**](https://peps.python.org/pep-3333/)) WSGI, o qual lhe permiti rodar em uma variedade de plataformas de servidores. ## Tenha seu banco de dados rodando 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 [PostgreSQL](http://www.postgresql.org/), [MySQL](https://www.mysql.com/), [Oracle](http://www.oracle.com/) e [SQLite](https://www.sqlite.org/). Se você está desenvolvendo um projeto simples ou alguma coisa que você não planeja implantar em um ambiente de produção, SQLite é geralmente a opção mais simples já que não requer que rode um servidor em separado. Porém, o SQLite tem muitas diferenças de outros bancos de dados, se você estiver trabalhando em algo substancial, é recomendado que você desenvolva com o mesmo banco de dados que planeja usar em produção. Além dos bancos de dados oficialmente suportados, existem [“backends” fornecidos por terceiros](/pt-br/1.9/ref/databases/#third-party-notes) que permitem que você use outros bancos de dados com o Django. Além do “backend” do banco de dados, você precisa assegurar que seus “bindings” para Python para o banco de dados estão instalados. - Se você estiver usando o PostgreSQL, você precisa do pacote [psycopg2](http://initd.org/psycopg/). Veja as [Notas sobre PostgreSQL](/pt-br/1.9/ref/databases/#postgresql-notes) para maiores detalhes. - Se você está usando MySQL, você irá precisar um [Driver para DB API](/pt-br/1.9/ref/databases/#mysql-db-api-drivers) como `mysqlclient`. Veja [notas para o Backend do MySQL](/pt-br/1.9/ref/databases/#mysql-notes) para detalhes. - Se você estiver usando SQLite você talvez queira ler as [Notas para o Backend do SQLite](/pt-br/1.9/ref/databases/#sqlite-notes). - Se você estiver usando Oracle, você irá precisar de uma cópia do [cx\_Oracle](http://cx-oracle.sourceforge.net/), mas por favor leia as [notas para o Backend do Oracle](/pt-br/1.9/ref/databases/#oracle-notes) para detalhes sobre versões suportadas para ambos o Oracle e o `cx_Oracle`. - Se você estiver usando um “backend” não oficial de terceiros, por favor consulte a documentação fornecida para qualquer requerimento adicional. Se você planeja usar o comando `manage.py migrate` 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 `SELECT`, `INSERT`, `UPDATE` and `DELETE` 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 [`DATABASES`](/pt-br/1.9/ref/settings/#std-setting-DATABASES) para detalhes. Se você está usando o [framework de testes](/pt-br/1.9/topics/testing/) do Django para testar consultas no banco de dados, o Django irá precisar de permissão para criar o banco de dados de teste. ## Remova qualquer versão antiga do Django Se estiver fazendo uma atualização de sua instalação do Django vindo uma versão anterior, você precisa desinstalar a versão antiga do Django antes de instalar a nova versão. Se você previamente instalou o Django usando o [pip](https://pip.pypa.io/) ou `easy_install`, instalando novamente com o [pip](https://pip.pypa.io/) ou `easy_install` eles irão automaticamente cuidar da versão anterior, de modo que não precisa fazer isso você mesmo. Se você previamente instalou o DJango usando `python setup.py install`, desinstalar é somente deletar o diretório `django` do seu Python `site-packages`. Para encontrar o diretório que você precisa remover, você pode executar o seguinte no “prompt” do seu “shell” (não no “prompt” interativo do Python): ```console $ python -c "import django; print(django.__path__)" ``` ## Instalando o código do Django. 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. É fácil, não importa a maneira que você escolheu. ### Instalando uma versão oficial com `pip` Este é o modo recomendável de instalar o Django. 1. Instale o [pip](https://pip.pypa.io/). A maneira mais fácil é usar o [standalone pip installer](https://pip.pypa.io/en/latest/installing/#installing-with-get-pip-py). Se sua distribuição já tem o `pip` instalado, você talvez precisa atualizá-lo se estiver desatualizado, você saberá porque a instalação não irá funcionar. 2. Dê uma olhada no [virtualenv](http://www.virtualenv.org/) e no [virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/). Essas ferramentas fornecem ambientes Python isolados, o qual é mais prático que instalar os pacotes no sistema. Eles também permitem instalar pacotes sem previlégios de administrador. O [tutorial de contribuição](/pt-br/1.9/intro/contributing/) passa por como criar um virtualenv para Python 3. 3. Depois que tenha criado e ativado um ambiente virtua, execute o comando `pip install Django` no “prompt” do seu shell. ### Instalando um pacote de uma distribuição específica. Verifique as [notas específicas de distribuições](/pt-br/1.9/misc/distributions/) 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. ### Instalando a versão de desenvolvimento. > **Acompanhando o desenvolvimento do Django.** > > Se você decidir usar a última versão de desenvolvimento do Django, você precisará acompanhar de perto o [the development timeline](https://code.djangoproject.com/timeline), e irá querer manter um olho no [notas de desenvolvimento para o próximo lançamento](/pt-br/1.9/releases/#development-release-notes). 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.) Se você quiser ser capaz de ocasionalmenete atualizar o seu código Django com as últimas correções e melhorias, siga estas instruções: 1. Assegure-se que tenha instalado o [Git](http://git-scm.com/) e que você pode executar seus comandos no seu shell. (Digite `git help` no “prompt” do seu shell para testar.) 2. Pegue o pricipal ramo de desenvolvimento do Django como aqui: ```console $ git clone git://github.com/django/django.git ``` Isso irá criar um diretório `django` no seu diretório corrente. 3. Assegure-se que o interpretador Python pode carregar o código do Django. A maneira mais conveniente de fazer isso é usar o [vittualenv](http://www.virtualenv.org/), [virtualenvwrapper](https://virtualenvwrapper.readthedocs.io/en/latest/), e [pip](https://pip.pypa.io/). O [tutorial de contribuição](/pt-br/1.9/intro/contributing/) passa por como criar um virtualenv no Python 3. 4. Depois de configurar e ativar o virtualenv, rode o seguinte comando: ```console $ pip install -e django/ ``` Isso fará com que o código do Django seja passível de importação, e fará co que o comando utilitário `django-admin` esteja disponível. Em outras palavras, você está pronto. Quando quiser atualizar sua cópia do código fonte do Django, apenas rode o comando `git pull` de dentro do diretório do Django. Quando fizer isso, o Git automaticamente irá baixar qualquer mudança.