Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Instale MongoDB Community Edition en Ubuntu

Nota

MongoDB Atlas

MongoDB Atlas es una opción para utilizar MongoDB alojada en la nube, que no requiere gastos en general de instalación y ofrece un clúster gratuito para comenzar.

Utiliza este tutorial para instalar MongoDB 7.0 Community Edition en versiones LTS (soporte a largo plazo) de Ubuntu Linux usando el administrador de paquetes apt.

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

MongoDB 7.0 Community Edition es compatible con las siguientes versiones de 64 bits de Ubuntu LTS (soporte a largo plazo) en arquitectura x86_64:

  • 22.04 LTS ("Jammy")

  • 20.04 LTS ("Focal")

MongoDB solo ofrece soporte para las versiones de 64 bits de estas plataformas. Para determinar qué versión de Ubuntu está ejecutando el host, se debe ejecutar el siguiente comando en el terminal del host:

cat /etc/lsb-release

MongoDB 7.0 Community Edition en Ubuntu también admite la arquitectura ARM64 en plataformas seleccionadas.

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

Antes de implementar MongoDB en un entorno de producción, consulta el documento Notas de producción para implementaciones autogestionadas para obtener consideraciones de rendimiento y recomendaciones de configuración.

Para instalar MongoDB Community en tu sistema Ubuntu, estas instrucciones utilizarán el paquete oficial mongodb-org, que es mantenido y respaldado por MongoDB Inc. El paquete oficial mongodb-org siempre contiene la última versión de MongoDB y está disponible desde su propio repositorio dedicado.

Importante

El paquete mongodb proporcionado por Ubuntu no está mantenido por MongoDB Inc. y entra en conflicto con el paquete oficial mongodb-org. Si ya instalaste el paquete mongodb en tu sistema Ubuntu, debes primero desinstalar el paquete mongodb antes de proceder con estas instrucciones.

Consulta los Paquetes de MongoDB Community Edition para la lista completa de paquetes oficiales.

Siga estos pasos para instalar MongoDB Community Edition usando el administrador de paquetes APT.

1

Desde un terminal, instale gnupg y curl si no están ya disponibles:

sudo apt-get install gnupg curl

Para importar la clave GPG pública de MongoDB, ejecute el siguiente comando:

curl -fsSL https://www.mongodb.org/static/pgp/server-7.0.asc | \ sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg \ --dearmor
2

Crea el archivo de lista /etc/apt/sources.list.d/mongodb-org-7.0.list para su versión de Ubuntu.

Se debe crear el archivo de lista para Ubuntu 22.04 (Jammy):

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list
3

Emita el siguiente comando para recargar la base de datos de paquetes local:

sudo apt-get update
4

Puede instalar la última versión estable de MongoDB o una versión específica de MongoDB.

Para instalar la última versión estable, emite el siguiente comando

sudo apt-get install -y mongodb-org

Para obtener ayuda con la solución de errores encontrados al instalar MongoDB en Ubuntu, consulta nuestra guía de solución de problemas.

La mayoría de los sistemas operativos similares a Unix limitan los recursos del sistema que un proceso puede utilizar. Estos límites pueden tener un impacto negativo en la operación de MongoDB y deben ajustarse. Se debe consultar Configuraciones de UNIX ulimit para implementaciones autogestionadas y conocer las configuraciones recomendadas para la plataforma.

Nota

Si el valor ulimit para el número de archivos abiertos es inferior a 64000, MongoDB genera una advertencia de inicio.

Si instalaste a través del administrador de paquetes, el directorio de datos /var/lib/mongodb y el directorio de registro /var/log/mongodb se crean durante la instalación.

Por defecto, MongoDB se ejecuta utilizando la cuenta de usuario mongodb. Si cambias el usuario que ejecuta el proceso de MongoDB, también debes modificar los permisos de los directorios de datos y registros para dar a este usuario acceso a estos directorios.

El paquete oficial de MongoDB incluye un archivo de configuración (/etc/mongod.conf). Estos ajustes (como las especificaciones del directorio de datos y del directorio de registros) entran en vigor al iniciar el sistema. Es decir, si cambias el archivo de configuración mientras se ejecuta la instancia de MongoDB, debes reiniciar la instancia para que los cambios surtan efecto.

Se debe seguir estos pasos para ejecutar MongoDB Community Edition en el sistema. Estas instrucciones asumen que se está utilizando el paquete mongodb-org oficial, no el paquete mongodb no oficial proporcionado por Ubuntu, y que se está utilizando la configuración por defecto.

Sistema de inicialización

Para ejecutar y gestionar su proceso mongod, utilice el sistema de inicialización integrado de su sistema operativo. Las versiones más recientes de Linux usan systemd, que utiliza el comando systemctl, mientras que las versiones más antiguas de Linux usan System V init, que utiliza el comando service.

Si no está seguro de qué sistema de inicialización utiliza su plataforma, ejecute el siguiente comando:

ps --no-headers -o comm 1

Luego, seleccione la pestaña adecuada a continuación según el resultado:

  • systemd - selecciona la pestaña systemd (systemctl) a continuación

  • init - selecciona la pestaña System V Init (service) a continuación.

1

Puedes iniciar el proceso mongod emitiendo el siguiente comando:

sudo systemctl start mongod

Si recibe un error similar al siguiente al iniciar mongod:

Failed to start mongod.service: Unit mongod.service not found.

Ejecute primero el siguiente comando:

sudo systemctl daemon-reload

Luego ejecuta de nuevo el comando de inicio mencionado arriba.

2
sudo systemctl status mongod

Puedes asegurarte opcionalmente de que MongoDB se inicie después de un reinicio del sistema emitiendo el siguiente comando:

sudo systemctl enable mongod
3

Según sea necesario, puedes detener el proceso mongod ejecutando el siguiente comando:

sudo systemctl stop mongod
4

Puedes reiniciar el proceso mongod emitiendo el siguiente comando:

sudo systemctl restart mongod

Puedes seguir el estado del proceso para detectar errores o mensajes importantes observando la salida en el archivo /var/log/mongodb/mongod.log.

5

Inicia una sesiónmongosh en la misma máquina host que el mongod. Puedes ejecutar mongosh sin opciones de línea de comandos para conectarse a un mongod que se ejecuta en su localhost con el puerto por defecto 27017.

mongosh

Para obtener más información sobre cómo conectarse usando mongosh, por ejemplo, para conectarse a una instancia mongod que se ejecuta en un host y/o puerto diferente, consulta la documentación de mongosh.

Para ayudarle a empezar a usar MongoDB, MongoDB provee Guías para comenzar para varias ediciones de controladores. Para la documentación del controlador, consulte Comience a desarrollar con MongoDB.

Para remover completamente MongoDB de un sistema, debe remover las aplicaciones de MongoDB, los archivos de configuración y cualquier directorio que contenga datos y registros. La siguiente sección le presenta una guía a través de los pasos necesarios.

Advertencia

Este proceso completamente removerá MongoDB, su configuración y todas las bases de datos. Este proceso no es reversible, así que asegúrese de que toda su configuración y datos estén respaldados antes de continuar.

1

Detenga el proceso de mongod emitiendo el siguiente comando:

sudo service mongod stop
2

Remueva cualquier paquete de MongoDB que haya instalado anteriormente.

sudo apt-get purge "mongodb-org*"
3

Remueva bases de datos de MongoDB y entradas de registro.

sudo rm -r /var/log/mongodbsudo rm -r /var/lib/mongodb

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 la instancia a una dirección IP de acceso público, se debe asegurar el clúster contra accesos no autorizados. Para obtener una lista completa de recomendaciones de seguridad, se debe consultar Checklist de seguridad para implementaciones autogestionadas. Como mínimo, se debe considerar 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.

MongoDB Community Edition está disponible en su propio repositorio dedicado y contiene los siguientes paquetes oficialmente soportados:

Nombre del paquete
Descripción

mongodb-org

Un metapackage que instala automáticamente los paquetes de componentes enumerados a continuación.

mongodb-org-database

Un metapackage que instala automáticamente los paquetes de componentes enumerados a continuación.

Nombre del paquete
Descripción

mongodb-org-server

Contiene el demonio mongod, el script de inicio asociado y un archivo de configuración (/etc/mongod.conf). Puede usar el script de inicialización para iniciar mongod con el archivo de configuración. Para más detalles, consulte la sección "Ejecutar MongoDB Community Edition", arriba.

mongodb-org-mongos

Contiene el demonio mongos.

mongodb-mongosh

Contiene el MongoDB Shell (mongosh).

mongodb-org-tools

Un metapackage que instala automáticamente los paquetes de componentes enumerados a continuación:

Nombre del paquete
Descripción

mongodb-database-tools

Contiene las siguientes herramientas de la base de datos MongoDB:

mongodb-org-database-tools-extra

Contiene el script install_compass