{"title":"Como instalar o Django no Windows","version":"4.1","locale":"pt-br","docname":"howto/windows","url":"/pt-br/4.1/howto/windows/","canonical":"https://djangodocs.dev/pt-br/4.1/howto/windows/","summary":"This document will guide you through installing Python 3.8 and Django on Windows. It also provides instructions for setting up a virtual environment, which makes it…","html":"<h1>Como instalar o Django no Windows<a class=\"heading-anchor\" href=\"#how-to-install-django-on-windows\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h1>\n<p>This document will guide you through installing Python 3.8 and Django on\nWindows. It also provides instructions for setting up a virtual environment,\nwhich makes it easier to work on Python projects. This is meant as a beginner’s\nguide for users working on Django projects and does not reflect how Django\nshould be installed when developing patches for Django itself.</p>\n<p>The steps in this guide have been tested with Windows 10. In other\nversions, the steps would be similar. You will need to be familiar with using\nthe Windows command prompt.</p>\n<section id=\"install-python\">\n<span id=\"install-python-windows\"></span><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, thus requiring Python to be installed on your\nmachine. At the time of writing, Python 3.8 is the latest version.</p>\n<p>To install Python on your machine go to <a class=\"reference external\" href=\"https://www.python.org/downloads/\">https://www.python.org/downloads/</a>. The\nwebsite should offer you a download button for the latest Python version.\nDownload the executable installer and run it. Check the boxes next to “Install\nlauncher for all users (recommended)” then click “Install Now”.</p>\n<p>Depois da instalação, abra a linha comando e verifique se a versão do Python é a mesma que a versão instalada executando:</p>\n<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 code\"><code><span class=\"gp\">...\\&gt;</span> py --version\n</code></pre></div>\n<aside class=\"admonition admonition-seealso\">\n<p class=\"admonition-title\">Ver também</p>\n<p>For more details, see <a class=\"reference external\" href=\"https://docs.python.org/3/using/windows.html\" title=\"(em Python v3.14)\"><span>Using Python on Windows</span></a> documentation.</p>\n</aside>\n</section>\n<section id=\"about-pip\">\n<h2>Sobre o <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code><a class=\"heading-anchor\" href=\"#about-pip\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<p><a class=\"reference external\" href=\"https://pypi.org/project/pip/\">pip</a> is a package manager for Python and is included by default with the\nPython installer. It helps to install and uninstall Python packages\n(such as Django!). For the rest of the installation, we’ll use <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code> to\ninstall Python packages from the command line.</p>\n</section>\n<section id=\"setting-up-a-virtual-environment\">\n<span id=\"virtualenvironment\"></span><h2>Setting up a virtual environment<a class=\"heading-anchor\" href=\"#setting-up-a-virtual-environment\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>It is best practice to provide a dedicated environment for each Django project\nyou create. There are many options to manage environments and packages within\nthe Python ecosystem, some of which are recommended in the <a class=\"reference external\" href=\"https://packaging.python.org/guides/tool-recommendations/\">Python\ndocumentation</a>.\nPython itself comes with <a class=\"reference external\" href=\"https://docs.python.org/3/tutorial/venv.html\" title=\"(em Python v3.14)\"><span class=\"xref std std-doc\">venv</span></a> for managing\nenvironments which we will use for this guide.</p>\n<p>To create a virtual environment for your project, open a new command prompt,\nnavigate to the folder where you want to create your project and then enter the\nfollowing:</p>\n<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 code\"><code><span class=\"gp\">...\\&gt;</span> py -m venv project-name\n</code></pre></div>\n<p>This will create a folder called ‘project-name’ if it does not already exist\nand set up the virtual environment. To activate the environment, run:</p>\n<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 code\"><code><span class=\"gp\">...\\&gt;</span> project-name\\Scripts\\activate.bat\n</code></pre></div>\n<p>The virtual environment will be activated and you’ll see “(project-name)” next\nto the command prompt to designate that. Each time you start a new command\nprompt, you’ll need to activate the environment again.</p>\n</section>\n<section id=\"install-django\">\n<h2>Instalando Django<a class=\"heading-anchor\" href=\"#install-django\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>O Django pode ser facilmente instalado dentro de seu ambiente virtual usando o <code class=\"docutils literal notranslate\"><span class=\"pre\">pip</span></code>.</p>\n<p>Na linha de comando, assegure-se que seu ambiente virtual esteja ativo, e execute o seguinte comando:</p>\n<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 code\"><code><span class=\"gp\">...\\&gt;</span> py -m pip install Django\n</code></pre></div>\n<p>Isso irá baixar e instalar a última versão do Django.</p>\n<p>Depois que a instalação for concluída, você pode verificar sua instalação do Django executando <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span> <span class=\"pre\">--version</span></code> na linha de comando.</p>\n<p>Veja <a class=\"reference internal\" href=\"/pt-br/4.1/topics/install/#database-installation\"><span class=\"std std-ref\">Tenha seu banco de dados rodando</span></a> para informações sobre a instalação do banco de dados com Django.</p>\n</section>\n<section id=\"colored-terminal-output\">\n<h2>Colored terminal output<a class=\"heading-anchor\" href=\"#colored-terminal-output\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<p>A quality-of-life feature adds colored (rather than monochrome) output to the\nterminal. In modern terminals this should work for both CMD and PowerShell. If\nfor some reason this needs to be disabled, set the environmental variable\n<span class=\"target\" id=\"index-0\"></span><a class=\"reference internal\" href=\"/pt-br/4.1/ref/django-admin/#envvar-DJANGO_COLORS\"><code class=\"xref std std-envvar docutils literal notranslate\"><span class=\"pre\">DJANGO_COLORS</span></code></a> to <code class=\"docutils literal notranslate\"><span class=\"pre\">nocolor</span></code>.</p>\n<p>On older Windows versions, or legacy terminals, <a class=\"reference external\" href=\"https://pypi.org/project/colorama/\">colorama</a> must be installed to\nenable syntax coloring:</p>\n<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 code\"><code><span class=\"gp\">...\\&gt;</span> py -m pip install colorama\n</code></pre></div>\n<p>See <a class=\"reference internal\" href=\"/pt-br/4.1/ref/django-admin/#syntax-coloring\"><span class=\"std std-ref\">Coloração de sintaxe</span></a> for more information on color settings.</p>\n</section>\n<section id=\"common-pitfalls\">\n<h2>Armadilhas comuns<a class=\"heading-anchor\" href=\"#common-pitfalls\"><span class=\"visually-hidden\">Link para este cabeçalho</span><span aria-hidden=\"true\">#</span></a></h2>\n<ul>\n<li><p>Se o  <code class=\"docutils literal notranslate\"><span class=\"pre\">django-admin</span></code> somente mostra o texto de ajuda não importando quais argumentos lhe é dado, provavelmente tem um problema com a associação do arquivo no windows. Verifique se existe mais de uma variável de ambiente definida para rodar os scripts Python no <code class=\"docutils literal notranslate\"><span class=\"pre\">PATH</span></code>. Isso normalmente ocorre quando existe mais de uma versão de Python instalada.</p></li>\n<li><p>If you are connecting to the internet behind a proxy, there might be problems\nin running the command <code class=\"docutils literal notranslate\"><span class=\"pre\">py</span> <span class=\"pre\">-m</span> <span class=\"pre\">pip</span> <span class=\"pre\">install</span> <span class=\"pre\">Django</span></code>. Set the environment\nvariables for proxy configuration in the command prompt as follows:</p>\n<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 code\"><code><span class=\"gp\">...\\&gt;</span> <span class=\"k\">set</span> <span class=\"nv\">http_proxy</span><span class=\"p\">=</span>http://username:password@proxyserver:proxyport\n<span class=\"gp\">...\\&gt;</span> <span class=\"k\">set</span> <span class=\"nv\">https_proxy</span><span class=\"p\">=</span>https://username:password@proxyserver:proxyport\n</code></pre></div>\n</li>\n<li><p>In general, Django assumes that <code class=\"docutils literal notranslate\"><span class=\"pre\">UTF-8</span></code> encoding is used for I/O. This may\ncause problems if your system is set to use a different encoding. Recent\nversions of Python allow setting the <span class=\"target\" id=\"index-1\"></span><a class=\"reference external\" href=\"https://docs.python.org/3/using/cmdline.html#envvar-PYTHONUTF8\" title=\"(em Python v3.14)\"><code class=\"xref std std-envvar docutils literal notranslate\"><span class=\"pre\">PYTHONUTF8</span></code></a> environment\nvariable in order to force a <code class=\"docutils literal notranslate\"><span class=\"pre\">UTF-8</span></code> encoding. Windows 10 also provides a\nsystem-wide setting by checking <code class=\"docutils literal notranslate\"><span class=\"pre\">Use</span> <span class=\"pre\">Unicode</span> <span class=\"pre\">UTF-8</span> <span class=\"pre\">for</span> <span class=\"pre\">worldwide</span> <span class=\"pre\">language</span>\n<span class=\"pre\">support</span></code> in <span class=\"menuselection\">Language ‣ Administrative Language Settings\n‣ Change system locale</span> in system settings.</p></li>\n</ul>\n</section>","rootId":"how-to-install-django-on-windows","toc":[{"title":"Instalando Python","anchor":"install-python","children":[]},{"title":"Sobre o pip","anchor":"about-pip","children":[]},{"title":"Setting up a virtual environment","anchor":"setting-up-a-virtual-environment","children":[]},{"title":"Instalando Django","anchor":"install-django","children":[]},{"title":"Colored terminal output","anchor":"colored-terminal-output","children":[]},{"title":"Armadilhas comuns","anchor":"common-pitfalls","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Guias de “como fazer”","url":"/pt-br/4.1/howto/"}],"prev":{"docname":"howto/static-files/deployment","title":"How to deploy static files","url":"/pt-br/4.1/howto/static-files/deployment/"},"next":{"docname":"howto/writing-migrations","title":"How to create database migrations","url":"/pt-br/4.1/howto/writing-migrations/"},"formats":{"html":"/pt-br/4.1/howto/windows/","markdown":"/pt-br/4.1/howto/windows.md","json":"/pt-br/4.1/howto/windows.json"},"source":"https://github.com/django/django/blob/stable/4.1.x/docs/howto/windows.txt","official":"https://docs.djangoproject.com/pt-br/4.1/howto/windows/","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","it","pt-br","ko","es","el","pl"]}