FAQ: Instalação¶
Como eu posso começar?¶
Instalando o Django (leia a guia de instalação).
Navegue pelo tutorial.
Confira o resto da documentação e faça perguntas se você tiver problemas.
Quais são os pré-requisitos do Django?¶
O Django requer Python. Veja a tabela na próxima questão para visualizar as versões de Python que funcionam com cada versão do Django. Outras bibliotecas Python podem ser requeridas para alguns casos de uso, mas você receberá um erro sobre elas na medida que forem necessárias.
Para um ambiente de desenvolvimento – se você quer apenas experimentar o Django – você não precisa ter um servidor web separado instalado ou servidor de banco de dados.
Django vem com seu próprio servidor de desenvolvimento. Para um ambiente de produção, o Django segue as especificações WSGI, PEP 3333, o que significa que é possível executar em uma variedade de servidores web. Veja a documentação Implementando o Django para mais informações.
Django executa SQLite por padrão, pois é incluso na instalação do Python. Para um ambiente de produção, recomendamos usar o PostgreSQL; mas também suportamos oficialmente MariaDB, MySQL, SQLite e Oracle. Veja :doc:Bancos de Dados Suportados</ref/databases>` para mais informações.
Qual versão do Python eu posso usar com Django?¶
Versão do Django |
Versões do Python |
|---|---|
3.2 |
3.6, 3.7, 3.8, 3.9, 3.10 (adicionado na versão 3.2.9) |
4.0 |
3.8, 3.9, 3.10 |
4.1 |
3.8, 3.9, 3.10, 3.11 (incluído na 4.1.3) |
4.2 |
3.8, 3.9, 3.10, 3.11, 3.12 (adicionados na 4.2.8) |
5.0 |
3.10, 3.11, 3.12 |
5.1 |
3.10, 3.11, 3.12, 3.13 (added in 5.1.3) |
Para cada versão do Python, apenas a micro versão (A.B.C) é oficialmente suportada. Você pode encontrar a micro versão mais recente para cada série na Página de downloads do Python.
Tipicamente, nós daremos suporte à uma versão Python até a primeira distribuição Django LTS, cujo suporte de segurança temine após o término do suporte de segurança para aquela versão do Python. Por exemplo, o suporte de segurança do Python 3.9 termina em outubro de 2025 e o suporte de segurança do Django 4.2 LTS encerra em abril de 2026. Portanto o Django 4.2 é a última versão que irá suportar Python 3.9.
Qual versão do Python eu devo usar com Django?¶
Uma vez que as versões mais recentes do Python são muitas vezes mais rápidas, têm mais recursos e são melhor suportadas, a última versão do Python 3 é recomendada.
Você não perde nada no Django por usar uma versão antiga, mas você não usufruirá das melhorias e otimizações das versões mais recentes de Python. As aplicações de terceiros para uso com Django são livres para definir os seus próprios requisitos de versão.
Eu devo usar a versão estável ou a versão de desenvolvimento?¶
Normalmente, se você está usando código em produção, você deve utilizar uma distribuição estável. O projeto Django publica uma distribuição estável completa a cada mais ou menos 8 meses, com atualizações de correções de bugs entre elas. Essas distribuições estáveis contém uma API que está coberta pelas nossas garantias de compatibilidade com a versão anterior; se você está escrevendo código nas distribuições estáveis, você não deve ter nenhum problema para atualizar quando a próxima versão oficial for distribuída.
