Instalar o MongoDB Community no Windows usando o arquivo Zip
Nesta página
Visão geral
Use este tutorial para instalar o MongoDB Community no Windows baixando e extraindo o arquivo zip.
Versão do MongoDB
Este tutorial instala o MongoDB 7.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 extraindo de um arquivo zip. Você também pode instalar o MongoDB no Windows por estes outros métodos:
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 7.0 Community Edition é compatível com as seguintes versões de 64 bits do Windows em 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 a MongoDB Community Edition a partir do arquivo zip.
Baixe o arquivozip.
Baixe o arquivo MongoDB Community .zip
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 x64.
No menu suspenso Package, selecione zip.
Clique em Download.
Criar arquivo de configuração (opcional).
Você pode criar um arquivo de configuração para especificar opções para MongoDB. Para fazer isso, crie um arquivo chamado mongod.cfg
no \bin\
diretório dentro do diretório onde você extraiu os arquivos MongoDB (<install directory>\bin\mongod.cfg
). Para obter mais informações sobre como criar um arquivo de configuração, consulte Arquivo de configuração.
Crie diretórios obrigatórios e opcionais.
O MongoDB precisa de um diretório de dados para armazenar seus dados. Por padrão, ele usa
C:\data\db
, mas você pode especificar um local diferente em seu arquivo de configuração. Você pode criar o diretório de dados usando o prompt de comando do Windows:mkdir c:\data\db Se você especificou um caminho de registro no arquivo de configuração, crie o diretório de registro da mesma maneira.
Inicie o MongoDB Community Edition a partir do Prompt de Comando
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\7.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\7.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:
Execute o MongoDB Community Edition como um serviço do Windows
Inicie o MongoDB Community Edition como serviço do Windows
Você pode instalar e configurar o MongoDB como um Windows Service durante a instalação, e o serviço MongoDB será iniciado após a instalação bem-sucedida.
Você também pode gerenciar manualmente o serviço na linha de comando. Para iniciar o serviço MongoDB a partir da linha de comando, abra um prompt de comando/interpretador do Windows (cmd.exe
) como Administrator e execute o seguinte comando:
Verifique se o MongoDB foi iniciado com sucesso.
Verifique seu arquivo de registro MongoDB para a seguinte linha:
[initandlisten] waiting for connections on port 27017
Você poderá ver avisos não críticos como resultado do processo. Contanto que você veja essa mensagem no registro do MongoDB, você pode ignorar com segurança esses avisos durante sua avaliação inicial do MongoDB.
Conecte-se ao servidor 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.
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).
Você também pode gerenciar o serviço na linha de comando. Para parar o serviço MongoDB da linha de comando, abra um prompt/interpretador de comando do Windows (cmd.exe
) como um Administrator e execute o seguinte comando:
net stop MongoDB
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
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 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
é atualizado automaticamente dentro da mesma série de versão (por exemplo: 7.2.1 para 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\7.0\bin
ao seu PATH
sistema, poderá omitir o caminho completo para os binários do MongoDB Server . Você também deve adicionar o caminho para o mongosh, caso ainda não o tenha feito.