Instale o MongoDB Community Edition no Windows
Nesta página
Observação
MongoDB Atlas
O MongoDB Atlas é uma opção de serviço MongoDB hospedada na nuvem que não requer nenhuma sobrecarga de instalação e oferece uma camada grátis para começar.
Visão geral
Use este tutorial para instalar o MongoDB 5.0 Community Edition no Windows usando o assistente de instalação padrão.
Versão do MongoDB
Este tutorial instala a MongoDB Community Edition 5.0. 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 com 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 está 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
MongoDB 5.0 O MongoDB Community Edition oferece suporte às seguintes versões de64bits do Windows na arquitetura x86_64 :
Servidor Windows 2019
Windows 10 / Windows servidor 2016
O MongoDB é compatível somente com as versões de 64 bits dessas plataformas.
Consulte Suporte da Plataforma para obter mais informações.
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 produção de sistemas do MongoDB.
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 apenas 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 é 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 integrada 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 .msi
não inclui o 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. Configure a instância do MongoDB com o arquivo de configuração <install directory>\bin\mongod.cfg
.
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 é iniciado 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 Conectar-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 comando/interpretador do Windows (cmd.exe
) em vez de 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\5.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\5.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 acessível a partir dos clientes remotos.
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 a um endereço IP não localhost (por exemplo, acessível publicamente), certifique-se de proteger seu cluster contra o acesso não autorizado. Para obter uma lista completa de recomendações de segurança, consulte a Lista de verificação de segurança para implementações autogerenciadas. No mínimo, procure 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\5.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.