Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

Instale o MongoDB Community Edition no macOS

Use este tutorial para instalar o MongoDB 8.0 Community Edition no macOS usando o gerenciador de pacotes Homebrew de terceiros.

A partir do MongoDB 4.4.1, instalar o MongoDB por meio do Homebrew também instala as Database Tools do MongoDB database. Consulte Usando as Database Tools do MongoDB para obter mais informações.

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.

MongoDB 8.0 A Community Edition oferece suporte para macOS 14 ou posterior em sistemas 64-bit Intel (x86_64, Hasell ou mais recente) e Apple Silicon (arm64).

Para obter mais informações, consulte Suporte à plataforma.

Antes de implantar o MongoDB em um ambiente de produção, consulte o documento Notas de produção para implementações autogerenciadas para obter considerações de desempenho e recomendações de configuração.

Certifique-se de que seu sistema atenda a cada um dos seguintes pré-requisitos. Você só precisa executar cada etapa de pré-requisito uma vez em seu sistema. Se você já executou as etapas de pré-requisito como parte de uma instalação MongoDB anterior usando Homebrew, você pode pular para o procedimento de instalação.

O Homebrew requer as ferramentas de linha de comando do Xcode da Apple.

  • Instale as ferramentas de linha de comando do Xcode executando o seguinte comando no Terminal do seu macOS:

    xcode-select --install

O macOS não inclui o pacote Homebrew brew por padrão.

Siga estas etapas para instalar o MongoDB Community Edition usando o gerenciador de pacotes brew da Homebrew. Certifique-se de ter seguido os pré-requisitos de instalação acima antes de continuar.

  1. Clique em Toque em Homebrew de MongoDB para baixar a fórmula oficial Homebrew para MongoDB e as Database Tools, executando o seguinte comando no seu Terminal macOS:

    brew tap mongodb/brew

    Em seguida, marque a torneira como uma fonte confiável:

    brew trust mongodb/brew

    Se já tiver feito isso para uma instalação anterior do MongoDB, você pode pular esta etapa.

  2. Para atualizar o Homebrew e todas as fórmulas existentes:

    brew update
  3. Para instalar o MongoDB, execute o seguinte comando em seu aplicativo Terminal do macOS:

    brew install mongodb-community@8.0

Dica

Alternativamente, você pode especificar uma versão anterior do MongoDB, se desejado. Você também pode manter múltiplas versões do MongoDB lado a lado desta maneira.

Dica

Se você tiver instalado anteriormente uma versão mais antiga da fórmula, você pode encontrar um ChecksumMismatchError. Para resolver o problema, consulte Solução de problemas de ChecksumMismatchError.

A instalação inclui os seguintes binários:

  • O servidor mongod

  • O roteador de consulta do cluster fragmentado do mongos

  • O MongoDB Shell, mongosh

Além disso, a instalação cria os seguintes arquivos e diretórios no local especificado abaixo, dependendo do seu hardware da Apple:

Processador Intel
Processador Apple Silicon

/usr/local/etc/mongod.conf

/opt/homebrew/etc/mongod.conf

/usr/local/var/log/mongodb

/opt/homebrew/var/log/mongodb

/usr/local/var/mongodb

/opt/homebrew/var/mongodb

See Apple's documentation for the current list of Apple hardware using the Apple Silicon processor. You can also run the following command to check where brew has installed these files and directories:

brew --prefix

A partir do MongoDB 4.4.1, a instalação também inclui o MongoDB Database Tools. Consulte Usando as Database Tools do MongoDB para obter mais informações.

Siga estas etapas para executar o MongoDB Community Edition. Estas instruções pressupõem que você esteja usando as configurações padrão.

Você pode executar o MongoDB como um serviço macOS usando brew ou pode executar o MongoDB manualmente como um processo de background. É recomendável executar o MongoDB como um serviço macOS, pois isso define os valores ulimit corretos do sistema automaticamente (consulte as configurações de ulimit para obter mais informações).

  • Para executar o MongoDB (ou seja, o processo mongod) como um serviço macOS, execute:

    brew services start mongodb-community@8.0

    Para interromper a execução de um mongod como um serviço macOS, use o seguinte comando, conforme necessário:

    brew services stop mongodb-community@8.0
  • Para executar mongod o manualmente como um processo de background utilizando um arquivo de configuração:

    • Se a sua implantação não utilizar conexões TLS, utilize a --fork opção:

      • Para macOS em execução em processadores Intel, execute:

        mongod --config /usr/local/etc/mongod.conf --fork
      • Para macOS em execução em processadores Apple Silicon, execute:

        mongod --config /opt/homebrew/etc/mongod.conf --fork
      • Se o seu sistema utilizar conexões TLS, utilize o GNU Screen.

        • Para macOS em execução em processadores Intel:

          1
          screen -S <name-of-screen>
          2
          mongod --config /usr/local/etc/mongod.conf
          3

          Desconecte-se da tela digitando Ctrl+a e clicando em d.

          4
          screen -ls
        • Para macOS em execução em processadores Apple Silicon:

          1
          screen -S <name-of-screen>
          2
          mongod --config /opt/homebrew/etc/mongod.conf
          3

          Desconecte-se da tela digitando Ctrl+a e clicando em d.

          4
          screen -ls
  • Para executar mongod manualmente como um processo em segundo plano especificando --dbpath e --logpath na linha de comando, execute:

    mongod --dbpath /path/to/dbdir --logpath /path/to/mongodb.log --fork

    To stop a mongod running as a background process, connect to the mongod using mongosh, and issue the shutdown command as needed.

Ambos os métodos usam o arquivo mongod.conf criado durante a instalação. Você também pode adicionar suas próprias opções de configuração do MongoDB a esse arquivo.

Observação

O macOS impede que o mongod Abra

macOS pode impedir que o mongod seja executado após a instalação. Se você receber um erro de segurança ao iniciar o mongod indicando que o desenvolvedor não pôde ser identificado ou verificado, faça o seguinte para conceder acesso ao mongod para executar:

  • Abra as Configurações do sistema

  • Clique em Privacidade e segurança na barra lateral.

  • Na seção Segurança, clique no botão Open Anyway à direita da mensagem sobre mongod.

Para verificar se o MongoDB está em execução, execute um dos seguintes procedimentos:

  • Se você iniciou o MongoDB como um serviço macOS:

    brew services list

    Você deverá ver o serviço mongodb-community listado como started.

  • Se você iniciou o MongoDB manualmente como um processo em segundo plano:

    ps aux | grep -v grep | grep mongod

    Você deverá ver o processo mongod na saída.

Você pode também consultar o arquivo de log para verificar o status atual do seu processo mongod: /usr/local/var/log/mongodb/mongo.log.

To begin using MongoDB, connect mongosh to the running instance. From a new terminal, issue the following:

mongosh

Para obter informações sobre operações de CRUD (criar, ler, atualizar, excluir), consulte:

A partir do MongoDB 4.4.1, a instalação do MongoDB pelo brew também instala as Database Tools do MongoDB.

The MongoDB Database Tools are a collection of command-line utilities for working with a MongoDB deployment, including data backup and import/export tools like mongoimport and mongodump as well as monitoring tools like mongotop.

Once you have installed the MongoDB Server in the steps above, the Database Tools are available directly from the command line in your macOS Terminal application. For example you could run mongotop against your running MongoDB instance by invoking it in your macOS Terminal like so:

mongotop

Ele deve iniciar, conectar-se ao seu mongodem execução e começar a relatar estatísticas de uso.

Consulte a documentação das Database Tools do MongoDB para obter informações de uso para cada uma das Database Tools.

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, ou

  • por 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.

Se você já instalou uma versão mais antiga da fórmula, poderá encontrar um ChecksumMismatchError semelhante a:

Error: An exception occurred within a child process:
ChecksumMismatchError: SHA256 mismatch
Expected: c7214ee7bda3cf9566e8776a8978706d9827c1b09017e17b66a5a4e0c0731e1f
Actual: 6aa2e0c348e8abeec7931dced1f85d4bb161ef209c6af317fe530ea11bbac8f0
Archive: /Users/kay/Library/Caches/Homebrew/downloads/a6696157a9852f392ec6323b4bb697b86312f0c345d390111bd51bb1cbd7e219--mongodb-macos-x86_64-4.2.0.tgz
To retry an incomplete download, remove the file above.

Para corrigir:

  1. Remova o arquivo .tgz baixado.

  2. Toque novamente na fórmula.

    brew untap mongodb/brew && brew tap mongodb/brew
  3. Tente instalar novamente.

    brew install mongodb-community@8.0