Instale o MongoDB Community Edition no Windows
Nesta página
Observação
MongoDB Atlas
O MongoDB Atlas é uma opção de serviço MongoDB hospedado em nuvem que não requer sobrecarga de instalação e oferece 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 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
MongoDB 5.0 O MongoDB Community Edition oferece suporte às seguintes versões de64bits do Windows na arquitetura x86_64 :
Windows Server 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 implantações de produção 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 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. 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 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 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
By default, MongoDB launches with bindIp
set to 127.0.0.1
, which binds to the localhost network interface. This means that the mongod.exe
can only accept connections from clients that are running on the same machine. Remote clients will not be able to connect to the mongod.exe
, and the mongod.exe
will not be able to initialize a replica set unless this value is set to a valid network interface which is accessible from the remote clients.
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 não localhost (por exemplo, acessível IP ), certifique-se de ter protegido 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.