Instale o MongoDB Community Edition no Ubuntu
Nesta página
Visão geral
Use este tutorial para instalar o MongoDB 8.0 MongoDB Community Edition em versões LTS (suporte de longo prazo) do Ubuntu Linux usando o gerenciador de pacote apt.
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.
Considerações
Suporte a plataformas
MongoDB 8.0 O Community Edition é compatível com as seguintes versões do Ubuntu LTS (suporte de longo prazo) de64bits na arquitetura x86_64:
24.04 LTS ("Noble")
22.04 LTS ("Jammy")
20.04 LTS ("Focal")
O MongoDB oferece suporte apenas às versões de 64 bits dessas plataformas. Para determinar qual versão do Ubuntu seu host está executando, execute o seguinte comando no terminal do host:
cat /etc/lsb-release
MongoDB 8.0 O Community Edition no Ubuntu também é compatível com a arquitetura ARM64 em plataformas selecionadas.
Consulte Suporte da Plataforma para obter mais informações.
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.
Pacotes oficiais do MongoDB
Para instalar o MongoDB Community em seu sistema Ubuntu, estas instruções utilizarão o pacote oficial do mongodb-org, que é mantido e suportado pela MongoDB Inc. O pacote oficial do mongodb-org sempre contém a versão mais recente do MongoDB e está disponível em seu próprio repositório dedicado.
Importante
O pacote mongodb fornecido pela Ubuntu não é mantido pela MongoDB Inc. e entra em conflito com o pacote mongodb-org oficial. Se você já tiver instalado o pacote mongodb em seu sistema Ubuntu, você deverá primeiro desinstalar o pacote mongodb antes de prosseguir com estas instruções.
Consulte Pacotes do MongoDB Community Edition para obter a lista completa de pacotes oficiais.
Instale o MongoDB Community Edition
Siga estas etapas para instalar o MongoDB Community Edition usando o gerenciador de pacotes apt.
Importe a chave pública.
A partir de um terminal, instale gnupg e curl, se ainda não estiverem disponíveis:
sudo apt-get install gnupg curl
Para importar a chave GPG pública do MongoDB, execute o seguinte comando:
curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | \ sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \ --dearmor
Crie o arquivo de lista.
Crie o arquivo de lista /etc/apt/sources.list.d/mongodb-org-8.0.list para sua versão do Ubuntu.
Crie o arquivo de lista para o Ubuntu 24.04 (Noble):
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
Crie o arquivo de lista para o Ubuntu 22.04 (Jammy):
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
Crie o arquivo de lista para o Ubuntu 20.04 (Focal):
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
Instale o servidor da MongoDB Community .
Você pode instalar a versão estável mais recente do MongoDB ou uma versão específica do MongoDB.
Para instalar a versão estável mais recente, emita o seguinte
sudo apt-get install -y mongodb-org
Para instalar uma versão específica, você deve especificar cada pacote de componente individualmente junto com o número da versão, como no exemplo a seguir:
sudo apt-get install -y mongodb-org=8.0.4 mongodb-org-database=8.0.4 mongodb-org-server=8.0.4 mongodb-mongosh mongodb-org-mongos=8.0.4 mongodb-org-tools=8.0.4
Se você instalar o mongodb-org=8.0.4 somente e não incluir os pacotes de componentes, a versão mais recente de cada pacote MongoDB será instalada independentemente da versão especificada.
Opcional. Embora você possa especificar qualquer versão disponível do MongoDB, o apt-get atualizará os pacotes quando uma versão mais nova se tornar disponível. Para evitar atualizações indesejadas, você pode fixar o pacote na versão que está instalada atualmente:
echo "mongodb-org hold" | sudo dpkg --set-selections echo "mongodb-org-database hold" | sudo dpkg --set-selections echo "mongodb-org-server hold" | sudo dpkg --set-selections echo "mongodb-mongosh hold" | sudo dpkg --set-selections echo "mongodb-org-mongos hold" | sudo dpkg --set-selections echo "mongodb-org-tools hold" | sudo dpkg --set-selections
Para obter ajuda na solução de erros encontrados ao instalar o MongoDB no Ubuntu, consulte nosso guia de solução de problemas.
Execute o MongoDB Community Edition
Considerações ulimit
A maioria dos sistemas operacionais do tipo Unix limita os recursos do sistema que um processo pode usar. Esses limites podem impacto negativamente a operação do MongoDB e devem ser ajustados. Consulte Configurações do UNIX ulimit para sistemas autogerenciados para obter as configurações recomendadas para sua plataforma.
Observação
Se o valor ulimit para o número de arquivos abertos estiver em 64000, o MongoDB gerará um aviso de inicialização.
Diretórios
Se você instalou pelo gerenciador de pacotes, o diretório de dados /var/lib/mongodb e o diretório de log /var/log/mongodb serão criados durante a instalação.
Por padrão, o MongoDB é executado usando a conta de usuário mongodb. Se você alterar o usuário que executa o processo MongoDB, você também deverá modificar a permissão para os dados e os diretórios de registros para conceder acesso a esses diretórios a esse usuário.
Arquivo de configuração
O pacote oficial MongoDB inclui um arquivo de configuração (/etc/mongod.conf). Essas configurações (como o diretório de dados e especificações do diretório de registros) entram em vigor após a inicialização. Ou seja, se você alterar o arquivo de configuração enquanto a instância do MongoDB estiver em execução, deverá reiniciar a instância para que as alterações entrem em vigor.
Procedimento
Siga estas etapas para executar o MongoDB Community Edition em seu sistema. Estas instruções pressupõem que você esteja usando o pacote oficial mongodb-org -- não o pacote mongodb não oficial fornecido pela Ubuntu -- e usando as configurações padrão.
Sistema de Inicialização
Para executar e gerenciar seu processo do mongod, você utilizará o sistema de inicialização integrado do sistema operacional. Versões recentes do Linux tendem a utilizar systemd (que utiliza o comando systemctl), enquanto versões mais antigas do Linux tendem a utilizar System V init (que utiliza o comando service).
Se você não tiver certeza de qual sistema de inicialização sua plataforma usa, execute o seguinte comando:
ps --no-headers -o comm 1
Em seguida, selecione a aba apropriada abaixo com base no resultado:
systemd- selecione a aba systemd (systemctl) abaixo.init- selecione a aba System V Init (service) abaixo.
Inicie o MongoDB.
Você pode iniciar o processo mongod emitindo o seguinte comando:
sudo systemctl start mongod
Se receber um erro semelhante ao seguinte ao iniciar o mongod:
Failed to start mongod.service: Unit mongod.service not found.
Execute o seguinte comando primeiro:
sudo systemctl daemon-reload
Em seguida, execute o comando de inicialização acima novamente.
Pare o MongoDB.
Conforme necessário, você pode interromper o processo mongod emitindo o seguinte comando:
sudo systemctl stop mongod
Reinicie o MongoDB.
Você pode reiniciar o processo mongod emitindo o seguinte comando:
sudo systemctl restart mongod
Você pode acompanhar o estado do processo em busca de erros ou mensagens importantes
observando o resultado no arquivo /var/log/mongodb/mongod.log.
Comece a usar o MongoDB.
Inicie uma sessão mongosh na mesma máquina host que o mongod. Você pode executar mongosh sem nenhuma opção de linha de comando para se conectar a um mongod que esteja sendo executado em seu host local com a porta padrão 27017.
mongosh
Para obter mais informações sobre como se conectar usando mongosh, como se conectar a uma instância mongod em execução em um host e/ou porta diferente, consulte a documentação do mongosh.
Para ajudá-lo a começar a usar o MongoDB, o MongoDB fornece Guias de Introdução em várias edições de driver. Para obter a documentação do driver, consulte Iniciar o desenvolvimento com o MongoDB.
Inicie o MongoDB.
Emita o seguinte comando para iniciar mongod:
sudo service mongod start
Verifique se o MongoDB foi iniciado com sucesso.
Verifique se o processo mongod foi iniciado com sucesso:
sudo service mongod status
Você também pode verificar no arquivo de log o status atual do processo mongod, localizado em: /var/log/mongodb/mongod.log por padrão. Uma instância mongod em execução indicará que está pronta para conexões com a seguinte linha:
[initandlisten] waiting for connections on port 27017
Pare o MongoDB.
Conforme necessário, você pode interromper o processo mongod emitindo o seguinte comando:
sudo service mongod stop
Reinicie o MongoDB.
Emita o seguinte comando para reiniciar mongod:
sudo service mongod restart
Comece a usar o MongoDB.
Inicie uma sessão mongosh na mesma máquina host que o mongod. Você pode executar mongosh sem nenhuma opção de linha de comando para se conectar a um mongod que esteja sendo executado em seu host local com a porta padrão 27017.
mongosh
Para obter mais informações sobre como se conectar usando mongosh, como se conectar a uma instância mongod em execução em um host e/ou porta diferente, consulte a documentação do mongosh.
Para ajudá-lo a começar a usar o MongoDB, o MongoDB fornece Guias de Introdução em várias edições de driver. Para obter a documentação do driver, consulte Iniciar o desenvolvimento com o MongoDB.
Desinstale o MongoDB Community Edition
Para remover completamente o MongoDB de um sistema, você deve remover os próprios aplicativos MongoDB, os arquivos de configuração e quaisquer diretórios que contenham dados e registros. A seção a seguir orienta você nas etapas necessárias.
Aviso
Esse processo removerá completamente o MongoDB, sua configuração e todos os bancos de dados. Este processo não é reversível, portanto, certifique-se de fazer backup de todas as suas configurações e dados antes de continuar.
Pare o MongoDB.
Interrompa o processo mongod com o seguinte comando:
sudo service mongod stop
Informaçõ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 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 e o mongod 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.
Pacotes do MongoDB Community Edition
O MongoDB Community Edition está disponível em seu próprio repositório dedicado e contém os seguintes pacotes com suporte oficial:
Nome do Pacote | Descrição | ||||||
|---|---|---|---|---|---|---|---|
| Um | ||||||
| Um
| ||||||
| Contém o MongoDB Shell ( | ||||||
| Um
|