Install mongosh

Import the public key used by the package management system.

From a terminal, issue the following command to import the MongoDB public GPG key from 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

The previous command writes the GPG key to your system's /etc/apt/trusted.gpg.d folder and prints the key to your terminal. You do not need to copy or save the key that is printed to the terminal.

If you receive an error indicating that gnupg is not installed, perform the following steps:

1. Install gnupg and its required libraries using the following command:

   sudo apt-get install gnupg

2. Retry importing the key:

   wget -qO- https://www.mongodb.org/static/pgp/server-8.0.asc | sudo tee /etc/apt/trusted.gpg.d/server-8.0.asc

Create a list file for MongoDB.

Create the list file /etc/apt/sources.list.d/mongodb-org-8.0.list for your version of Ubuntu.

Click on the appropriate tab for your version of Ubuntu. If you are unsure of what Ubuntu version the host is running, open a terminal or shell on the host and run lsb_release -dc.

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

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

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

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

Reload local package database.

Issue the following command to reload the local package database:

sudo apt-get update

Install the mongosh package.

mongosh supports OpenSSL. You can also configure mongosh to use your system's OpenSSL installation.

To install the latest stable version of mongosh with the included OpenSSL libraries:

sudo apt-get install -y mongodb-mongosh

To install mongosh with your OpenSSL 1.1 libraries:

sudo apt-get install -y mongodb-mongosh-shared-openssl11

To install mongosh with your OpenSSL 3.0 libraries:

sudo apt-get install -y mongodb-mongosh-shared-openssl3

Confirm that mongosh installed successfully.

To confirm that mongosh installed successfully, run the following command:

mongosh --version

Your terminal should respond with the version of mongosh you have installed.

Configure the package management system (yum).

Create a /etc/yum.repos.d/mongodb-org-8.0.repo file so that you can install mongosh directly using yum.

There are .rpm distributions for RHEL and Amazon Linux.

• Choose the tab to select the file for your distribution.

• Copy the contents of the tab.

• Paste the contents into the .repo file.

[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

[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

Install mongosh.

mongosh supports OpenSSL. You can also configure mongosh to use your system's OpenSSL installation.

To install the latest stable version of mongosh with the included OpenSSL libraries:

sudo yum install -y mongodb-mongosh

To install mongosh with your OpenSSL 1.1 libraries:

sudo yum install -y mongodb-mongosh-shared-openssl11

To install mongosh with your OpenSSL 3.0 libraries:

sudo yum install -y mongodb-mongosh-shared-openssl3

Open the MongoDB Shell download page.

Open the MongoDB Download Center.

Download the Linux 64-bit .tgz package.

Download the appropriate version of mongosh for your operating system. MongoDB also provides versions of mongosh that use your system's OpenSSL installation.

See the MongoDB Download Center.

Extract the files from the downloaded archive.

Go to the directory that contains the .tgz archive, then unpack the archive.

The name of the .tgz package varies depending on the version you downloaded. Replace the .tgz package name in the following command with the name of the package you downloaded and run the command.

tar -zxvf mongosh-2.4.0-linux-x64.tgz

The extracted archive has a bin folder that contains two files, mongosh and mongosh_crypt_v1.so.

If your web browser automatically extracts the archive as part of the download, or if you extract the archive without using the tar command, you may need to make the binary executable.

To make the binary executable, run the following command in the directory where you extracted the archive:

chmod +x bin/mongosh

Add the downloaded binaries to your PATH environment variable.

You can either:

• Copy the mongosh binary into a directory listed in your PATH variable, such as /usr/local/bin. Run the following commands from the directory where you extracted the download file:

  sudo cp mongosh /usr/local/bin/
  sudo cp mongosh_crypt_v1.so /usr/local/lib/

• Create symbolic links to the MongoDB Shell. Switch to the directory where you extracted the files from the .tgz archive. Run the following command to create links to a directory already in your PATH such as /usr/local/bin.

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