- Install MongoDB Community Edition on Debian
- Overview
- MongoDB Version
- Considerations
- Platform Support
- Production Notes
- Official MongoDB Packages
- Important
- Install MongoDB Community Edition
- Import the public key used by the package management system.
- Create a /etc/apt/sources.list.d/mongodb-org-6.0.list file for MongoDB.
- Reload local package database.
- Install the MongoDB packages.
- Run MongoDB Community Edition
- Note
- Procedure
- Install MongoDB Community on Ubuntu using .tgz Tarball
- Overview
- MongoDB Version
- Installation Method
- Considerations
- MongoDB Shell, mongosh
- Platform Support
- Note
- EOL Notice
- Production Notes
- Install MongoDB Community Edition
- Prerequisites
- Procedure
- Download the tarball.
- Extract the files from the downloaded archive.
- Tip
- Optional. Ensure the binaries are in a directory listed in your PATH environment variable.
Install MongoDB Community Edition on Debian
is a hosted MongoDB service option in the cloud which requires no installation overhead and offers a free tier to get started.
Overview
Use this tutorial to install MongoDB 6.0 Community Edition using the apt package manager.
MongoDB Version
This tutorial installs MongoDB 6.0 Community Edition. To install a different version of MongoDB Community , use the version drop-down menu in the upper-left corner of this page to select the documentation for that version.
Considerations
Platform Support
MongoDB 6.0 Community Edition supports the following 64-bit Debian releases on x86_64 architecture:
MongoDB only supports the 64-bit versions of these platforms.
See Platform Support for more information.
Production Notes
Before deploying MongoDB in a production environment, consider the Production Notes document which offers performance considerations and configuration recommendations for production MongoDB deployments.
Official MongoDB Packages
To install MongoDB Community on your Debian system, these instructions will use the official mongodb-org package, which is maintained and supported by MongoDB Inc. The official mongodb-org package always contains the latest version of MongoDB, and is available from its own dedicated repo.
Important
The mongodb package provided by Debian is not maintained by MongoDB Inc. and conflicts with the official mongodb-org package. If you have already installed the mongodb package on your Debian system, you must first uninstall the mongodb package before proceeding with these instructions.
See MongoDB Community Edition Packages for the complete list of official packages.
Install MongoDB Community Edition
Follow these steps to install MongoDB Community Edition using the apt package manager.
Import the public key used by the package management system.
From a terminal, install gnupg and curl if they are not already available:
sudo apt-get install gnupg curl
Issue the following command to import the MongoDB public GPG Key from https://pgp.mongodb.com/server-6.0.asc
curl -fsSL https:/ /pgp.mongodb.com/server- 6.0.asc | \ sudo gpg -o /usr/share/keyrings/mongodb-server- 6.0.gpg \ --dearmor
Create a /etc/apt/sources.list.d/mongodb-org-6.0.list file for MongoDB.
Create the list file using the command appropriate for your version of Debian:
Reload local package database.
Issue the following command to reload the local package database:
Install the MongoDB packages.
You can install either the latest stable version of MongoDB or a specific version of MongoDB.
Optional. Although you can specify any available version of MongoDB, apt-get will upgrade the packages when a newer version becomes available. To prevent unintended upgrades, you can pin the package at the currently installed version:
echo "mongodb-org hold" | sudo dpkg --set-selections echo "mongodb-org-database hold" | sudo dpkg --set-selections echo "mongodb-org-server hold" | sudo dpkg --set-selections echo "mongodb-mongosh hold" | sudo dpkg --set-selections echo "mongodb-org-mongos hold" | sudo dpkg --set-selections echo "mongodb-org-tools hold" | sudo dpkg --set-selections
Run MongoDB Community Edition
ulimit Considerations Most Unix-like operating systems limit the system resources that a process may use. These limits may negatively impact MongoDB operation, and should be adjusted. See UNIX ulimit Settings for the recommended settings for your platform.
Note
Starting in MongoDB 4.4, a startup error is generated if the ulimit value for number of open files is under 64000 .
Procedure
Follow these steps to run MongoDB Community Edition on your system. These instructions assume that you are using the official mongodb-org package — not the unofficial mongodb package provided by Debian — and are using the default settings.
Init System
To run and manage your mongod process, you will be using your operating system’s built-in init system. Recent versions of Linux tend to use systemd (which uses the systemctl command), while older versions of Linux tend to use System V init (which uses the service command).
If you are unsure which init system your platform uses, run the following command:
Then select the appropriate tab below based on the result:
- systemd — select the systemd (systemctl) tab below.
- init — select the System V Init (service) tab below.
Install MongoDB Community on Ubuntu using .tgz Tarball
is a hosted MongoDB service option in the cloud which requires no installation overhead and offers a free tier to get started.
Overview
Use this tutorial to manually install MongoDB 6.0 Community Edition on LTS (long-term support) releases of Ubuntu Linux using a downloaded .tgz tarball.
MongoDB Version
This tutorial installs MongoDB 6.0 Community Edition. To install a different version of MongoDB Community , use the version drop-down menu in the upper-left corner of this page to select the documentation for that version.
Installation Method
While MongoDB can be installed manually via a downloaded .tgz tarball as described in this document, it is recommended to use the apt package manager on your system to install MongoDB if possible. Using a package manager automatically installs all needed dependencies, provides an example mongod.conf file to get you started, and simplifies future upgrade and maintenance tasks.
Considerations
MongoDB Shell, mongosh
When you use the .tgz package to install the server, you need to follow the mongosh installation instructions to download and install mongosh separately.
Platform Support
Note
EOL Notice
- MongoDB 5.0 Community Edition removes support for Ubuntu 16.04 on x86_64
- MongoDB 5.0 Community Edition removes support for Ubuntu 18.04 on s390x
MongoDB 6.0 Community Edition supports the following 64-bit Ubuntu LTS (long-term support) releases on x86_64 architecture:
- 22.04 LTS («Jammy») (Starting in MongoDB 6.0.4)
- 20.04 LTS («Focal»)
- 18.04 LTS («Bionic»)
- 16.04 LTS («Xenial»)
MongoDB only supports the 64-bit versions of these platforms.
MongoDB 6.0 Community Edition on Ubuntu also supports the ARM64 architecture on select platforms.
See Platform Support for more information.
Production Notes
Before deploying MongoDB in a production environment, consider the Production Notes document which offers performance considerations and configuration recommendations for production MongoDB deployments.
Install MongoDB Community Edition
Prerequisites
Use the following command to install the dependencies required for the MongoDB Community .tgz tarball:
Procedure
Follow these steps to manually install MongoDB Community Edition from the .tgz .
Download the tarball.
After you have installed the required prerequisite packages, download the MongoDB Community tgz tarball from the following link:
- In the Version dropdown, select the version of MongoDB to download.
- In the Platform dropdown, select your operating system version and architecture.
- In the Package dropdown, select tgz .
- Click Download .
Extract the files from the downloaded archive.
Using an archive manager program or the tar command, extract the files.
For example, to extract from the terminal shell, you can use the following tar command:
Tip
If you downloaded a different MongoDB 6.0 point release, be sure to modify the command to reflect the correct .tgz file name.
tar -zxvf mongodb-linux-*-6.0.7.tgz
Optional. Ensure the binaries are in a directory listed in your PATH environment variable.
The MongoDB binaries are in the /bin/ directory.
To avoid having to specify the path to the MongoDB binaries, you can create symbolic links to the binaries from a directory listed in your PATH variable, such as /usr/local/bin . Update /path/to/the/mongodb-directory/ with your installation directory as appropriate.
sudo ln -s /path/to/the/mongodb-directory/bin /* /usr/local/bin /
Alternatively, you can copy these binaries into a directory listed in your PATH variable such as /usr/local/bin .