Docs Menu
Docs Home
/ /
Community Edition
/ / / /

Instale MongoDB Community Edition en macOS

Nota

MongoDB Atlas

MongoDB Atlas es una opción de servicio MongoDB alojado en la nube que no requiere instalación y ofrece un nivel gratuito para comenzar.

Utilice este tutorial para instalar MongoDB 6.0 Community Edition en macOS usando Homebrew de terceros gestor de paquetes

A partir de MongoDB, al 4.4.1 instalar MongoDB mediante Homebrew también se instalan las Herramientas de Base de Datos de MongoDB. Consulte "Uso de las Herramientas de Base de Datos de MongoDB" para obtener más información.

Este tutorial instala MongoDB 6.0 Community Edition. Para instalar una versión diferente de MongoDB Community, utilice el menú desplegable de versiones en la esquina superior izquierda de esta página para seleccionar la documentación correspondiente.

Nota

EOL Notice

  • MongoDB 5.0 Community Edition elimina la compatibilidad con macOS 10.13

MongoDB 6.0 Community Edition es compatible con macOS 10.14 o posterior.

Ver Soporte de la plataforma para obtener más información.

Antes de implementar MongoDB en un entorno de producción, considera el documento Notas de Producción para Implementaciones Autogestionadas, que ofrece consideraciones de rendimiento y recomendaciones de configuración para implementaciones de MongoDB en producción.

Asegúrese de que su sistema cumpla con cada uno de los siguientes requisitos previos. Solo necesita realizar cada paso previo una vez en su sistema. Si ya ha realizado los pasos previos como parte de una instalación anterior de MongoDB usando Homebrew, puede saltar directamente al procedimiento de instalación.

Homebrew requiere las herramientas de línea de comandos de Xcode de Apple.

  • Instale las herramientas de línea de comandos de Xcode ejecutando el siguiente comando en su Terminal de macOS:

    xcode-select --install

macOS no incluye Homebrew brew paquete por defecto.

Siga estos pasos para instalar MongoDB Community Edition usando el administrador de paquetes brew de Homebrew. Asegúrese de haber seguido los prerrequisitos de instalación mencionados anteriormente antes de proceder.

  1. Tocar MongoDB Homebrew Tap para descargar la fórmula oficial de Homebrew para MongoDB y las Database Tools, mediante el siguiente comando en el terminal de macOS:

    brew tap mongodb/brew

    Si ya lo ha hecho en una instalación anterior de MongoDB, puede omitir este paso.

  2. To update Homebrew and all existing formulae:

    brew update
  3. Para instalar MongoDB, ejecute el siguiente comando en su aplicación Terminal de macOS:

    brew install mongodb-community@6.0

Tip

Alternativamente, puede especificar una versión anterior de MongoDB si lo desea. También puede mantener múltiples versiones de MongoDB en paralelo de esta manera.

Tip

Si has instalado previamente una versión anterior de la fórmula, puedes encontrarte con un ChecksumMismatchError. Para resolverlo, consulta Solución de problemas de ChecksumMismatchError.

La instalación incluye los siguientes binarios:

Además, la instalación crea los siguientes archivos y directorios en la ubicación especificada a continuación, dependiendo del hardware de su Apple:

Procesador Intel
Apple Silicon Processor

/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

Consulta la documentación de Apple para obtener la lista actual de hardware de Apple que utiliza el procesador Apple Silicon. También puedes ejecutar el siguiente comando para verificar dónde brew ha instalado estos archivos y directorios:

brew --prefix

A partir de MongoDB 4.4.1, la instalación también incluye MongoDB Database Tools. Consulta Usar MongoDB Database Tools para obtener más información.

Se deben seguir estos pasos para ejecutar MongoDB Community Edition. Estas instrucciones asumen que se está utilizando la configuración por defecto.

You can run MongoDB as a macOS service using brew, or you can run MongoDB manually as a background process. It is recommended to run MongoDB as a macOS service, as doing so sets the correct system ulimit values automatically (see ulimit settings for more information).

  • Para ejecutar MongoDB (es decir, el proceso mongod) como un servicio en macOS, ejecute:

    brew services start mongodb-community@6.0

    Para detener un mongod que se está ejecutando como servicio de macOS, utilice el siguiente comando según sea necesario:

    brew services stop mongodb-community@6.0
  • Para ejecutar mongod manualmente como un proceso en segundo plano usando un archivo de configuración:

    • Si su implementación no utiliza conexiones TLS, utilice la opción --fork:

      • Para macOS ejecutándose en procesadores Intel, ejecute:

        mongod --config /usr/local/etc/mongod.conf --fork
      • Para macOS con procesadores Apple Silicon, ejecuta:

        mongod --config /opt/homebrew/etc/mongod.conf --fork
      • Si su implementación utiliza conexiones TLS, utilice GNU Screen.

        • Para macOS ejecutándose en procesadores Intel:

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

          Desconéctese de la pantalla escribiendo Ctrl+a y luego haciendo clic en d.

          4
          screen -ls
        • Para macOS con procesadores Apple Silicon:

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

          Desconéctese de la pantalla escribiendo Ctrl+a y luego haciendo clic en d.

          4
          screen -ls
  • Para ejecutar mongod manualmente como un proceso en segundo plano especificando --dbpath y --logpath en la línea de comandos, ejecute:

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

    Para detener un mongod que se ejecuta como proceso en segundo plano, conéctate al mongod usando mongosh, y ejecuta el comando shutdown, según sea necesario.

Ambos métodos utilizan el archivo mongod.conf creado durante la instalación. También puede añadir sus propias opciones de configuración de MongoDB a este archivo.

Nota

MacOS impide que mongod se abra

MacOS puede impedir que mongod se ejecute después de la instalación. Si recibe un error de seguridad al iniciar mongod que indica que el desarrollador no pudo ser identificado o verificado, haga lo siguiente para conceder acceso a mongod para ejecutar:

  • Abra Preferencias del sistema

  • Seleccione el panel Seguridad y privacidad.

  • En la pestaña General, haga clic en el botón a la derecha del mensaje sobre, etiquetado mongod como Open Anyway o Allow Anyway dependiendo de tu versión de macOS.

To verify that MongoDB is running, perform one of the following:

  • Si inició MongoDB como un servicio de macOS:

    brew services list

    Debería ver el servicio mongodb-community listado como started.

  • Si se inició MongoDB manualmente como un proceso en segundo plano:

    ps aux | grep -v grep | grep mongod

    Debería ver su proceso mongod en la salida.

También puede ver la entrada de registro para ver el estado actual de su proceso mongod: /usr/local/var/log/mongodb/mongo.log.

Para comenzar a utilizar MongoDB, conecte mongosh a la instancia en ejecución. Desde un nuevo terminal, ejecute lo siguiente:

mongosh

For information on CRUD (Create,Read,Update,Delete) operations, see:

A partir de MongoDB 4.4.1, la instalación de MongoDB a través de brew también instala las herramientas de base de datos de MongoDB.

MongoDB Database Tools son una colección de utilidades de línea de comandos para trabajar con una implementación de MongoDB, que incluye herramientas de copia de seguridad de datos e importación/exportación como mongoimport y mongodump, así como herramientas de supervisión como mongotop.

Una vez que haya instalado el MongoDB Server según los pasos anteriores, las Database Tools están disponibles directamente desde la línea de comandos en su aplicación Terminal de macOS. Por ejemplo, podría ejecutar mongotop contra su instancia de MongoDB en ejecución invocándola en su Terminal de macOS de la siguiente manera:

mongotop

Debería iniciarse, conectarse a su mongod en ejecución y comenzar el reporte de estadísticas de uso.

Consulta la Documentación sobre MongoDB Database Tools para obtener información sobre el uso de cada una de las herramientas de Database Tools.

By default, MongoDB launches with bindIp set to 127.0.0.1, which binds to the localhost network interface. This means that the mongod can only accept connections from clients that are running on the same machine. Remote clients will not be able to connect to the mongod, and the mongod 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 se puede configurar:

  • en el archivo de configuración de MongoDB con bindIp, o

  • mediante el argumento de la línea de comandos --bind_ip

Advertencia

Antes de vincular una dirección IP que no sea local (por ejemplo, de acceso público), asegúrese de proteger su clúster contra accesos no autorizados. Para obtener una lista completa de recomendaciones de seguridad, consulte la Lista de verificación de seguridad para implementaciones autogestionadas. Como mínimo, considere habilitar la autenticación y reforzar la infraestructura de red.

Para obtener más información sobre cómo configurar bindIp, consulta Vinculación de IP en Implementaciones Autogestionadas.

Si ha instalado previamente una versión anterior de la fórmula, podría encontrarse con un ChecksumMismatchError que se asemeja al siguiente:

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

  1. Remove the downloaded .tgz archive.

  2. Retap the formula.

    brew untap mongodb/brew && brew tap mongodb/brew
  3. Vuelva a intentar la instalación.

    brew install mongodb-community@6.0

Volver

Instala usando .tgz Tarball

En esta página