Instale o MongoDB Community Edition no Windows
Nesta página
Visão geral
Use este tutorial para instalar o MongoDB 8.0 Community Edition no Windows usando o assistente de instalação padrão.
Versão do MongoDB
Este tutorial instala o MongoDB 8.0 Community Edition. Para instalar uma versão diferente do MongoDB Community, use o menu suspenso de versão no canto superior esquerdo desta página para selecionar a documentação dessa versão.
Método de instalação
Este tutorial instala o MongoDB no Windows usando o assistente de instalação MSI padrão. Para instalar o MongoDB usando a ferramenta de linha de comando msiexec.exe, consulte Instalar o MongoDB usando msiexec.exe. A ferramenta msiexec.exe é útil para administradores de sistemas que desejam implantar o MongoDB de forma autônoma por meio de automação.
Considerações
MongoDB Shell, mongosh
O MongoDB Shell (mongosh) não é instalado com o MongoDB Server. Você precisa seguir as instruções de instalação do mongosh para baixar e instalar o mongosh separadamente.
Suporte a plataformas
O MongoDB 8.0 Community Edition é compatível com as seguintes 64 versões do Windows bits na arquitetura x86_64:
Windows Server 2022
Windows Server 2019
Windows 11
O MongoDB é compatível somente com as versões de 64 bits dessas plataformas.
Para obter mais informações, consulte Suporte à plataforma.
Observação
O MongoDB não é compatível ao subsistema do Windows para Linux (WSL). Para executar o MongoDB no Linux, use um sistema Linux compatível.
Virtualização
A Oracle oferece suporte experimental para VirtualBox em hosts Windows onde o Hyper-V está sendo executado. No entanto, a Microsoft não oferece suporte ao VirtualBox no Hyper-V.
Desative o Hyper-V se quiser instalar o MongoDB no Windows com o VirtualBox.
Notas de produção
Antes de implantar o MongoDB em um ambiente de produção, considere o documento Notas de produção para implantações autogerenciadas, que oferece considerações de desempenho e recomendações de configuração para implantações de produção do MongoDB.
Captura de dados de diagnóstico em tempo integral
O MongoDB registra os dados de diagnóstico para ajudar na solução de problemas. Para obter informações detalhadas, consulte Captura de dados de diagnóstico em tempo integral.
No Windows, para coletar dados do sistema, como disco, cpu e memória, o FTDC exige permissões de acesso da Microsoft dos seguintes grupos:
Usuários do monitor de desempenho
Usuários de registro de desempenho
Se o usuário executando o mongod e mongos não for um administrador, adicione-o a estes grupos para registrar dados FTDC. Para obter mais informações, consulte a documentação da Microsoft aqui.
Instale o MongoDB Community Edition
Procedimento
Siga estas etapas para instalar o MongoDB Community Edition usando o assistente de instalação do MongoDB. O processo de instalação instala os binários MongoDB, como também, o arquivo de configuração <install
directory>\bin\mongod.cfg padrão.
Baixe o instalador.
Baixe o instalador do MongoDB Community .msi a partir do seguinte link:
➤ Centro de downloads do MongoDB
Na menu suspenso Version, selecione a versão do MongoDB para baixar.
No menu suspenso Platform, selecione Windows.
No menu suspenso Package, selecione msi.
Clique em Download.
Siga o assistente de instalação do MongoDB Community Edition
O assistente orienta na instalação do MongoDB e do MongoDB Compass.
- Choose Setup Type
- Você pode escolher o Complete (recomendado para a maioria dos usuários) ou tipo de configuração Custom. A opção Complete de configuração instala as ferramentas MongoDB e MongoDB no local padrão. A opção Custom de configuração permite a você especificar quais executáveis serão instalados e onde.
- Service Configuration
Você pode configurar o MongoDB como um serviço do Windows durante a instalação ou simplesmente instalar os binários.
Você pode configurar e iniciar o MongoDB como um serviço do Windows durante a instalação, e o serviço MongoDB será iniciado após a instalação bem-sucedida.
Selecione Install MongoD as a Service.
Selecione uma destas opções:
Run the service as Network Service user (Padrão)
Esta é uma conta de usuário do Windows que está incorporada ao Windows.
Run the service as a local or domain user
Para uma conta de usuário local existente, especifique um período (
.) para o Account Domain e especifique o Account Name e o Account Password para o usuário.Para um usuário de domínio existente, especifique o Account Domain, Account Name e Account Password para esse usuário.
Service Name. Especifique o nome do serviço. O nome padrão é
MongoDB. Se você já tiver um serviço com o nome especificado, deverá escolher outro nome.Data Directory. Especifique o diretório de dados, que corresponde a
--dbpath. Se o diretório não existir, o instalador criará o diretório e definirá o acesso do diretório para o usuário do serviço.Log Directory. Especifique o diretório Log, que corresponde ao
--logpath. Se o diretório não existir, o instalador criará o diretório e definirá o acesso do diretório para o usuário do serviço.
Se você optar por não configurar o MongoDB como um serviço do Windows, desmarque a opção Install MongoD as a Service.
- Install MongoDB Compass
- Opcional. Para que o assistente instale o MongoDB Compass, selecione Install MongoDB Compass (Padrão).
Quando estiver pronto, clique em Install.
Instalar mongosh
O instalador do .msi não inclui mongosh. Siga as instruções de instalação do mongosh para baixar e instalar o shell separadamente.
Se você instalou o MongoDB como um serviço do Windows
O serviço MongoDB começa após a instalação bem-sucedida.
Se quiser personalizar o serviço, você deverá interrompê-lo. Personalize a instância do MongoDB editando o arquivo de configuração em <install directory>\bin\mongod.cfg.
Para obter informações sobre as opções de configuração disponíveis, consulte Opções de arquivo de configuração autogerenciado.
Depois de fazer alterações, inicie o serviço novamente.
Se você não instalou o MongoDB como um serviço do Windows
Se você instalou apenas os executáveis e não instalou o MongoDB como um serviço do Windows, deverá iniciar manualmente a instância do MongoDB.
Consulte Executar o MongoDB Community Edition a partir do interpretador de comandos para obter instruções sobre como iniciar uma instância do MongoDB.
Execute o MongoDB Community Edition como um serviço do Windows
Você pode instalar e configurar o MongoDB como um Windows Service durante a instalação. O serviço MongoDB começa após a instalação bem-sucedida. Configure a instância do MongoDB com o arquivo de configuração <install directory>\bin\mongod.cfg.
Se ainda não tiver feito isso, siga as instruções de instalação do mongosh para baixar e instalar o MongoDB Shell (mongosh).
Adicione o caminho do binário mongosh.exe para sua variável de ambiente do PATH durante a instalação.
Abra um novo Command Interpreter e insira mongosh.exe para se conectar ao MongoDB.
Para mais informações sobre conectar a um mongod utilizando mongosh.exe, como conectar-se a uma instância do MongoDB em execução em um host e/ou porta diferente, consulte Conecte-se a uma implantação.
Para obter informações sobre operações de CRUD (criar, ler, atualizar, excluir), consulte:
Inicie o MongoDB Community Edition como serviço do Windows
Para iniciar/reiniciar o serviço MongoDB, use o console de serviços:
No console de serviços, localize o serviço MongoDB.
Clique com o botão direito no serviço MongoDB e clique em Start.
Interromper o MongoDB Community Edition como serviço do Windows
Para interromper ou pausar o serviço MongoDB, utilize o console de serviços:
No console de serviços, localize o serviço MongoDB.
Clique com o botão direito do mouse no serviço MongoDB e clique em Stop (ou Pause).
Remover o MongoDB Community Edition como serviço do Windows
Para remover o serviço MongoDB, primeiro use o console Serviços para interromper o serviço. Em seguida, abra um prompt de comando/interpretador do Windows (cmd.exe) como um Administrator e execute o seguinte comando:
sc.exe delete MongoDB
Execute o MongoDB Community Edition a partir do prompt de comando
Você pode executar o MongoDB Community Edition a partir do prompt de comandos do Windows (cmd.exe) em vez de executar como um serviço.
Abra um prompt de comando/interpretador do Windows (cmd.exe) como Administrator.
Importante
Você deve abrir o prompt de comando como um Administrator.
Criar diretório do banco de dados.
Crie o diretório de dados onde MongoDB armazena dados. O caminho do diretório de dados padrão do MongoDB é o caminho absoluto \data\db no drive a partir do qual você inicia o MongoDB.
A partir do Command Interpreter, crie os diretórios de dados:
cd C:\ md "\data\db"
Inicie o banco de dados MongoDB.
Para iniciar o MongoDB, execute mongod.exe.
"C:\Program Files\MongoDB\Server\8.0\bin\mongod.exe" --dbpath="c:\data\db"
A opção --dbpath aponta para o diretório do seu banco de dados.
Se o servidor de banco de dados MongoDB estiver sendo executado corretamente, o Command Interpreter exibirá:
[initandlisten] waiting for connections
Importante
Dependendo das configurações do Firewall do Windows Defender no seu host Windows, o Windows poderá exibir uma caixa de diálogo Security Alert referente ao bloqueio de "alguns recursos" referentes à comunicação de rede no C:\Program Files\MongoDB\Server\8.0\bin\mongod.exe. Para solucionar este problema:
Clique em Private Networks, such as my home or work network.
Clique em Allow access.
Para saber mais sobre segurança e MongoDB, consulte a Documentação de segurança.
Conecte-se ao MongoDB.
Se ainda não tiver feito isso, siga as instruções de instalação do mongosh para baixar e instalar o MongoDB Shell (mongosh).
Adicione o caminho do binário mongosh.exe para sua variável de ambiente do PATH durante a instalação.
Abra um novo Command Interpreter e insira mongosh.exe para se conectar ao MongoDB.
Para mais informações sobre como conectar ao mongod usando o mongosh.exe, como conectar-se a uma instância do MongoDB em execução em um host e/ou porta diferente, consulte Conectar-se a uma implantação.
Para obter informações sobre operações de CRUD (criar, ler, atualizar, excluir), consulte:
Considerações adicionais
Vinculação ao localhost por padrão
Por padrão, o MongoDB é iniciado com bindIp, definido como 127.0.0.1, que se vincula à interface de rede localhost. Isso significa que o mongod.exe só pode aceitar conexões de clientes que estejam executando na mesma máquina. Os clientes remotos não conseguirão se conectar ao mongod.exe e o mongod.exe não conseguirá inicializar um conjunto de réplicas, a menos que esse valor seja definido como uma interface de rede válida.
Este valor pode ser configurado de duas maneiras:
no arquivo de configuração do MongoDB com
bindIp, oupor meio do argumento linha de comando
--bind_ip
Aviso
Antes de vincular sua instância a um endereço IP acessível publicamente, você deve proteger seu cluster contra o acesso não autorizado. Para obter uma lista completa de recomendações de segurança, consulte Lista de verificação de segurança para implantações autogerenciadas. No mínimo, considere habilitar a autenticação e fortalecer a infraestrutura de rede.
Para obter mais informações sobre como configurar bindIp, consulte Vinculação de IP em implementações autogerenciadas.
Liberações de pontos e .msi
Se você instalou o MongoDB com o instalador do Windows (.msi), o .msi atualiza automaticamente dentro de sua série de versões (por exemplo 7.2.1 a 7.2.2).
A atualização de uma série completa de versões (por exemplo. 6.0 a 7.0) exige uma nova instalação.
Adicione os binários MongoDB ao PATH do sistema
Se você adicionar C:\Program Files\MongoDB\Server\8.0\bin ao seu sistema PATH, você pode omitir o caminho completo para os binários do servidor MongoDB. Você também deve adicionar o caminho para o mongosh, caso ainda não o tenha feito.