Pré-requisitos
Para usar o MongoDB Shell, você deve ter uma implantação MongoDB para se conectar.
Para uma implantação hospedada na nuvem gratuita, você pode utilizar o MongoDB Atlas.
Para saber como executar uma implantação do MongoDB, consulte Instalar o MongoDB.
Versões MongoDB suportadas
Você pode usar o MongoDB Shell para se conectar à versão 4.2 ou superior do MongoDB.
Sistemas operacionais suportados
Você pode instalar o MongoDB Shell 2.0.0 nestes sistemas operacionais:
Sistema operacional | Versões suportadas |
|---|---|
macOS | 11+ (x64 e ARM64) |
Microsoft Windows | Microsoft Windows Server 2016+ Microsoft Windows 10+ |
Linux | Red Hat Enterprise Linux (RHEL) 8+ (x64, ARM64, ppc64le e s390x) Ubuntu 20.04+ (x64 and ARM64) Amazon Linux 2023 (x64 and ARM64) Amazon Linux 2 (x64 and ARM64) Debian 11+ SLES 15 Oracle Linux 8+ running the Red Hat Compatible Kernel (RHCK). MongoDB Shell does not support the Unbreakable Enterprise Kernel (UEK). |
Considerações de compatibilidade
A partir de mongosh 2.0.0:
Amazon Linux 1, Debian 9 e macOS 10.14 não são compatíveis.
Red Hat Enterprise Linux (RHEL) 7, Amazon Linux 2, SUSE Linux Enterprise Server (SLES) 12, e o suporte Ubuntu 18,04 é preterido e pode ser removido em uma versão
mongoshposterior.
Procedimento
Selecione a guia apropriada para o seu sistema operacional:
Observação
No Windows, as preferências do mongosh e opções de configuração são armazenadas no diretório do %APPDATA%/mongodb/mongosh.
Instalar a partir de MSI
Abra a página de downloads do MongoDB Shell.
Abra o Centro de downloads do MongoDB..
Instalar do arquivo .zip
Abra a página de downloads do MongoDB Shell.
Abra o Centro de downloads do MongoDB..
Baixe o arquivo de instalação mongosh para seu sistema operacional.
Baixe o mongosh na Central de download do MongoDB.
Adicione o binário mongosh à sua variável de ambiente PATH.
Certifique-se de que o binário MongoDB Shell extraído esteja no local desejado em seu sistema de arquivos e, em seguida, adicione esse local à sua variável de ambiente do PATH.
Para adicionar a localização do binário MongoDB Shell à sua variável do ambiente PATH:
Abra o Control Panel.
Na categoria System and Security, clique em System.
Clique em Advanced system settings. O modal Propriedades do sistema é exibido.
Clique em Environment Variables.
Na seção Variáveis do sistema , selecione
Pathe clique em Edit. O modal Editar variáveis de ambiente é exibido.Clique em New e adicione o caminho de arquivo ao binário
mongosh.Clique em OK para confirmar suas alterações. Em cada um dos outros modais, clique em OK para confirmar suas alterações.
Para confirmar se a variável do ambiente PATH está configurada corretamente para localizar mongosh, abra um prompt de comando e digite o comando mongosh --help. Se o PATH estiver configurado corretamente, uma lista de comandos válidos será exibida.
Instalar com Homebrew
Importante
Para ver a lista completa de requisitos de sistema para o Homebrew, consulte o site do Homebrew.
O gerenciador de pacotes Homebrew é o método de instalação recomendado para mongosh no macOS. Para saber como instalar manualmente mongosh de um arquivo, consulte Instalar a partir de um arquivo .zip.
Considerações
O mongosh instalado com o Homebrew não oferece suporte à criptografia automática em nível de campo do lado do cliente.
Procedimento
Para instalar o mongosh com Homebrew:
Instale o Homebrew.
Consulte o website Homebrew para saber as etapas de instalação do Homebrew no macOS.
Instalar do arquivo .zip
Para instalar manualmente o mongosh usando um arquivo .zip baixado:
Abra a página de downloads do MongoDB Shell.
Abra o Centro de downloads do MongoDB..
Extraia os arquivos do arquivo baixado.
Go para o diretório que contém o arquivo mongosh .zip e descompacte o arquivo .zip .
Se o seu computador for baseado em Intel, execute:
unzip mongosh-2.5.6-darwin-x64.zip
Se o seu computador for baseado em ARM (M1 ou M2), execute:
unzip mongosh-2.5.6-darwin-arm64.zip
O arquivo extraído tem uma pasta bin que contém dois arquivos, mongosh e mongosh_crypt_v1.dylib.
Se o seu navegador extrair automaticamente o arquivo como parte do download, ou se você extrair o arquivo sem usar o comando unzip , talvez seja necessário tornar o binário executável.
Para tornar o binário executável, execute o seguinte comando no diretório onde você extraiu o arquivo:
chmod +x bin/mongosh
Adicione os binários baixados à sua variável de ambiente PATH.
Você também pode:
Copie o binário
mongoshpara um diretório listado na sua variávelPATH, como/usr/local/bin. Execute os seguintes comandos do diretório onde você extraiu o arquivo baixado:sudo cp mongosh /usr/local/bin/ sudo cp mongosh_crypt_v1.so /usr/local/lib/ Crie links simbólicos para o
MongoDB Shell. Alterne para o diretório onde você extraiu os arquivos do arquivo.tgz. Execute o seguinte comando para criar links para um diretório que já está em seuPATH, como/usr/local/bin.sudo ln -s $(pwd)/bin/* /usr/local/bin/
Permitir que o macOS seja executado mongosh.
macOS pode impedir que mongosh seja executado após a instalação. Se você receber um erro de segurança ao iniciar o mongosh indicando que o programador não pôde ser identificado ou verificado, execute a seguinte ação:
Abra Preferências do Sistema.
Selecione o painel Segurança e Privacidade.
Na guia Geral , clique no botão à direita da mensagem sobre
mongosh, rotulado com Open Anyway ou Allow Anyway dependendo da sua versão do macOS.
Selecione abaixo a aba apropriada com base na distribuição do Linux e no pacote desejado:
Para instalar o pacote
.debno Ubuntu 22.04 (Jammy), Ubuntu 20.04 (Focal), Ubuntu 18.04 (Bionic) ou Debian, clique na aba.deb.Para instalar o pacote
.rpmno RHEL, Amazon Linux 2023 ou Amazon Linux 2, clique na aba.rpm.Para instalar o tarball
.tgz, clique na aba.tgz.
Plataformas suportadas
mongosh está disponível como um PPA para as seguintes plataformas:
Ubuntu 24.04 (Noble Numbat)
Ubuntu 22.04 (Jammy)
Ubuntu 20.04 (Focal)
Ubuntu 18.04 (Bionic)
Procedimento
Importe a chave pública utilizada pelo sistema de gerenciamento de pacotes.
Em um terminal, emita o seguinte comando para importar a chave GPG pública do MongoDB de https://www.mongodb.org/static/pgp/server-8.0.asc:
wget -qO- https://www.mongodb.org/static/pgp/server-8.0.asc | sudo tee /etc/apt/trusted.gpg.d/server-8.0.asc
O comando anterior grava a chave GPG na pasta /etc/apt/trusted.gpg.d do seu sistema e imprime a chave no seu terminal. Não é necessário copiar ou salvar a chave impressa no terminal.
Se você receber um erro indicando que o gnupg não está instalado, execute as seguintes etapas:
Instale o
gnupge suas bibliotecas exigidas utilizando o seguinte comando:sudo apt-get install gnupg Tente importar a chave novamente:
wget -qO- https://www.mongodb.org/static/pgp/server-8.0.asc | sudo tee /etc/apt/trusted.gpg.d/server-8.0.asc
Crie um arquivo de lista para o MongoDB.
Crie o arquivo de lista /etc/apt/sources.list.d/mongodb-org-8.0.list para sua versão do Ubuntu.
Clique na aba apropriada para a sua versão do Ubuntu. Se você não tiver certeza de qual versão do Ubuntu o host está executando, abra um terminal ou shell no host e execute lsb_release -dc.
A instrução a seguir é para o Ubuntu 24.04 (Noble Numbot). Para outras versões do Ubuntu, clique na guia apropriada.
Crie o arquivo /etc/apt/sources.list.d/mongodb-org-8.0.list para o Ubuntu 24.04 (Noble Numbot):
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
The following instruction is for Ubuntu 22.04 (Jammy). Para outras versões do Ubuntu, clique na aba apropriada.
Crie o arquivo /etc/apt/sources.list.d/mongodb-org-8.0.list para o Ubuntu 22.04 (Jammy):
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
A instrução a seguir é para Ubuntu 20.04 (Focal). Para outras versões do Ubuntu, clique na guia apropriada.
Crie o arquivo /etc/apt/sources.list.d/mongodb-org-8.0.list para o Ubuntu 20.04 (Focal):
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
A instrução a seguir é para o Ubuntu 18.04 (Bionic). Para outras versões do Ubuntu, clique na aba apropriada.
Crie o arquivo /etc/apt/sources.list.d/mongodb-org-8.0.list para o Ubuntu 18.04 (Bionic):
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
Instale o pacote mongosh.
mongosh suporta OpenSSL. Você também pode configurar o mongosh para usar a instalação do OpenSSL do seu sistema.
Para instalar a versão estável mais recente do mongosh com as bibliotecas OpenSSL incluídas:
sudo apt-get install -y mongodb-mongosh
Para instalar o mongosh com suas bibliotecas OpenSSL 1.1:
sudo apt-get install -y mongodb-mongosh-shared-openssl11
Para instalar o mongosh com suas bibliotecas OpenSSL 3.0:
sudo apt-get install -y mongodb-mongosh-shared-openssl3
Plataformas suportadas
O mongosh está disponível como pacote yum para as seguintes plataformas:
RHEL
Amazon Linux 2023
Amazon Linux 2
Procedimento
Configure o sistema de gerenciamento de pacotes (yum).
Crie um arquivo /etc/yum.repos.d/mongodb-org-8.0.repo para instalar o mongosh diretamente utilizando o yum.
Existem distribuições .rpm para rhel e Amazon Linux.
Escolha a aba para selecionar o arquivo para sua distribuição.
Copie o conteúdo da guia.
Cole o conteúdo no arquivo
.repo.
[mongodb-org-8.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/redhat/$releasever/mongodb-org/8.0/$basearch/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-8.0.asc
Você também pode baixar os arquivos .rpm diretamente do repositório MongoDB. Os downloads são organizados na seguinte ordem:
Versão da Red Hat ou do CentOS (por exemplo,
8)Edição do MongoDB (por exemplo,
mongodb-enterprise)Versão de lançamento do MongoDB (por exemplo,
8.0)Arquitetura (por exemplo,
x86_64)
[mongodb-org-8.0] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/8.0/$basearch/ gpgcheck=1 enabled=1 gpgkey=https://www.mongodb.org/static/pgp/server-8.0.asc
Observação
Se o seu sistema usar Amazon Linux 2, substitua 2023 por 2 no baseurl.
Você também pode baixar os arquivos .rpm diretamente do repositório MongoDB. Os downloads são organizados na seguinte ordem:
Versão do Amazon Linux (por exemplo,
2023)Versão de lançamento do MongoDB (por exemplo,
8.0)Arquitetura (por exemplo,
x86_64)
Instale mongosh o.
mongosh suporta OpenSSL. Você também pode configurar o mongosh para usar a instalação do OpenSSL do seu sistema.
Para instalar a versão estável mais recente do mongosh com as bibliotecas OpenSSL incluídas:
sudo yum install -y mongodb-mongosh
Para instalar o mongosh com suas bibliotecas OpenSSL 1.1:
sudo yum install -y mongodb-mongosh-shared-openssl11
Para instalar o mongosh com suas bibliotecas OpenSSL 3.0:
sudo yum install -y mongodb-mongosh-shared-openssl3
Procedimento
Abra a página de downloads do MongoDB Shell.
Abra o Centro de downloads do MongoDB..
Faça o download do pacote Linux 64-bit .tgz.
Baixe a versão apropriada do mongosh para seu sistema operacional. O MongoDB também fornece versões do mongosh que usam a instalação OpenSSL do seu sistema.
Consulte o Centro de download do MongoDB.
Extraia os arquivos do arquivo baixado.
Go para o diretório que contém o arquivo .tgz e descompacte o arquivo.
O nome do pacote .tgz varia dependendo da versão que você baixou. Substitua o nome do pacote .tgz no comando a seguir pelo nome do pacote que você baixou e execute o comando.
tar -zxvf mongosh-2.5.6-linux-x64.tgz
O arquivo extraído tem uma pasta bin que contém dois arquivos, mongosh e mongosh_crypt_v1.so.
Se o seu navegador extrair automaticamente o arquivo como parte do download, ou se você extrair o arquivo sem usar o comando tar , talvez seja necessário tornar o binário executável.
Para tornar o binário executável, execute o seguinte comando no diretório onde você extraiu o arquivo:
chmod +x bin/mongosh
Adicione os binários baixados à sua variável de ambiente PATH.
Você também pode:
Copie o binário
mongoshpara um diretório listado na sua variávelPATH, como/usr/local/bin. Execute os seguintes comandos do diretório onde você extraiu o arquivo baixado:sudo cp mongosh /usr/local/bin/ sudo cp mongosh_crypt_v1.so /usr/local/lib/ Crie links simbólicos para o
MongoDB Shell. Alterne para o diretório onde você extraiu os arquivos do arquivo.tgz. Execute o seguinte comando para criar links para um diretório que já está em seuPATH, como/usr/local/bin.sudo ln -s $(pwd)/bin/* /usr/local/bin/
Próximos passos
Depois de instalar mongosh com sucesso, saiba como se conectar à implantação do MongoDB.
O MongoDB fornece uma lista programaticamente acessível de downloads de mongosh que podem ser acessados por meio de seu aplicativo.