Menu Docs
Página inicial do Docs
/
MongoDB Shell

Instalar o mongosh

Nesta página

Pré-requisitos

Para usar o MongoDB Shell, você deve ter uma implantação MongoDB para se conectar.

  • Para uma implantação gratuita hospedada na nuvem, você pode usar 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 mongosh posterior.

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

1

Abra a página de downloads do MongoDB Shell.

Abra o Centro de downloads do MongoDB..

2

No menu suspenso Platform, selecione Windows 64-bit (8.1+) (MSI)

3

Clique em Download.

4

Clique duas vezes no arquivo do instalador.

5

Siga as instruções para instalar o mongosh.

Instalar do arquivo .zip

1

Abra a página de downloads do MongoDB Shell.

Abra o Centro de downloads do MongoDB..

2

Faça download do arquivo de instalação mongosh para seu sistema operacional.

Baixe o mongosh na Central de download do MongoDB.

3

Extraia os arquivos do arquivo baixado.

Abra um terminal cmd e execute o seguinte comando a partir do diretório que tem o arquivo mongosh .zip:

tar -xf mongosh-2.4.0-win32-x64.zip

O arquivo extraído tem uma pasta bin que contém dois arquivos, mongosh.exe e mongosh_crypt_v1.dll.

4

Adicione o binário mongosh à variável do 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:

  1. Abra o Control Panel.

  2. Na categoria System and Security, clique em System.

  3. Clique em Advanced system settings. O modal Propriedades do sistema é exibido.

  4. Clique em Environment Variables.

  5. Na seção Variáveis do sistema , selecione Path e clique em Edit. O modal Editar variáveis de ambiente é exibido.

  6. Clique em New e adicione o caminho de arquivo ao binário mongosh.

  7. 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 a partir de um arquivo, consulte Instalar a partir de .zip arquivo.

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:

1
Instale o Homebrew.

Consulte o website Homebrew para saber as etapas de instalação do Homebrew no macOS.

2
Instale o pacote mongosh .

Emita o seguinte comando do terminal para instalar o pacote mongosh :

brew install mongosh

Instalar do arquivo .zip

Para instalar manualmente o mongosh usando um arquivo .zip baixado:

1

Abra a página de downloads do MongoDB Shell.

Abra o Centro de downloads do MongoDB..

2

Faça download do arquivo de instalação mongosh para seu sistema operacional.

Baixe a versão apropriada do mongosh para seu sistema operacional. O MongoDB fornece versões do mongosh para arquiteturas Intel e ARM.

3

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.4.0-darwin-x64.zip

Se o seu computador for baseado em ARM (M1 ou M2), execute:

unzip mongosh-2.4.0-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
4

Adicione os binários baixados à variável do ambiente PATH .

Você também pode:

  • Copie o binário mongosh para um diretório listado na sua variável PATH , 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 seu PATH , como /usr/local/bin.

    sudo ln -s $(pwd)/bin/* /usr/local/bin/
5

Permita que o macOS execute o 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:

  1. Abra Preferências do Sistema.

  2. Selecione o painel Segurança e Privacidade.

  3. 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 .deb no Ubuntu 22.04 (Jammy), Ubuntu 20.04 (Focal), Ubuntu 18.04 (Bionic) ou Debian, clique na aba .deb .

  • Para instalar o pacote .rpm no RHEL, Amazon Linux 2023 ou Amazon Linux 2, clique na aba .rpm .

  • Para instalar o tarball .tgz, clique na aba .tgz.

Plataformas suportadas

O 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

1

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:

  1. Instale o gnupg e suas bibliotecas exigidas utilizando o seguinte comando:

    sudo apt-get install gnupg

  2. 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
2

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
3

Recarregue o reconhecimento de data center do pacote local.

Dê o seguinte comando para recarregar a base de dados do pacote local:

sudo apt-get update
4

Instale o pacote mongosh .

mongosh suporta OpenSSL. Você também pode configurar o mongosh para utilizar a instalação 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
5

Confirme se mongosh foi instalado com sucesso.

Para confirmar que o mongosh foi instalado com sucesso, execute o seguinte comando:

mongosh --version

Seu terminal deve responder com a versão do mongosh que você instalou.

Plataformas suportadas

O mongosh está disponível como pacote yum para as seguintes plataformas:

  • RHEL

  • Amazon Linux 2023

  • Amazon Linux 2

Procedimento

1

Configurar 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:

  1. Versão da Red Hat ou do CentOS (por exemplo, 8)

  2. Edição do MongoDB (por exemplo, mongodb-enterprise)

  3. Versão de lançamento do MongoDB (por exemplo, 8.0)

  4. 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:

  1. Versão do Amazon Linux (por exemplo, 2023)

  2. Versão de lançamento do MongoDB (por exemplo, 8.0)

  3. Arquitetura (por exemplo, x86_64)

2

Instalar mongosh.

mongosh suporta OpenSSL. Você também pode configurar o mongosh para utilizar a instalação 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

1

Abra a página de downloads do MongoDB Shell.

Abra o Centro de downloads do MongoDB..

2

Baixe o pacote Linux .tgz de 64 bits.

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.

3

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.4.0-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
4

Adicione os binários baixados à variável do ambiente PATH .

Você também pode:

  • Copie o binário mongosh para um diretório listado na sua variável PATH , 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 seu PATH , 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.

Voltar

Bem-vindo ao MongoDB Shell (mongosh)

Próximo

Verificar a integridade do pacote