Docs Menu

Docs HomeDevelop ApplicationsMongoDB Manual

Verify Integrity of MongoDB Packages

On this page

  • Verify Linux/macOS Packages
  • Verify Windows Packages

The MongoDB release team digitally signs all software packages to certify that a particular MongoDB package is a valid and unaltered MongoDB release. Before installing MongoDB, you should validate the package using either the provided PGP signature or SHA-256 checksum.

PGP signatures provide the strongest guarantees by checking both the authenticity and integrity of a file to prevent tampering.

Cryptographic checksums only validate file integrity to prevent network transmission errors.

MongoDB signs each release branch with a different PGP key. The public key files for each release branch since MongoDB 2.2 are available for download from the key server in both textual .asc and binary .pub formats.

1

Download the binaries from MongoDB Download Center based on your environment. You can select different platforms and versions on that page. Click Copy link and use the URL in the following instructions.

For example, to download the 7.0.6 release for macOS through the shell, run this command:

curl -LO https://fastdl.mongodb.org/osx/mongodb-macos-x86_64-7.0.6.tgz

To download the 7.0.6 release for Linux through the shell, run this command:

curl -LO https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-ubuntu2204-7.0.6.tgz
2

For MacOS, run this command:

curl -LO https://fastdl.mongodb.org/osx/mongodb-macos-x86_64-7.0.6.tgz.sig

For Linux, run this command:

curl -LO https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-ubuntu2204-7.0.6.tgz.sig
3

If you have not downloaded and imported the MongoDB 7.0.6 public key, run these commands:

curl -LO https://pgp.mongodb.com/server-7.0.6.asc
gpg --import server-7.0.6.asc

PGP should return this response:

gpg: key 4B7C549A058F8B6B: "MongoDB 7.0.6 Release Signing Key <packaging@mongodb.com>" imported
gpg: Total number processed: 1
gpg: imported: 1
4

For MacOS, run this command:

gpg --verify mongodb-macos-x86_64-7.0.6.tgz.sig mongodb-macos-x86_64-7.0.6.tgz

For Linux, run this command, using the correct filename for your platform:

gpg --verify mongodb-linux-x86_64-ubuntu2204-7.0.6.tgz.sig mongodb-linux-x86_64-ubuntu2204-7.0.6.tgz

GPG should return this response:

gpg: Signature made Wed Jun 5 03:17:20 2019 EDT
gpg: using RSA key 4B7C549A058F8B6B
gpg: Good signature from "MongoDB 7.0 Release Signing Key <packaging@mongodb.com>" [unknown]

If the package is properly signed, but you do not currently trust the signing key in your local trustdb, gpg will also return the following message :

gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: E162 F504 A20C DF15 827F 718D 4B7C 549A 058F 8B6B

If you receive the following error message, confirm that you imported the correct public key:

gpg: Can't check signature: public key not found
1

Download the binaries from MongoDB Download Center based on your environment. You can select different platforms and versions on that page. Click Copy link and use the URL in the following instructions.

For example, to download the 7.0.6 release for macOS through the shell, type this command:

curl -LO https://fastdl.mongodb.org/osx/mongodb-macos-x86_64-7.0.6.tgz

To download the 7.0.6 release for Linux through the shell, run this command:

curl -LO https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-ubuntu2204-6.0.8.tgz
2

To download the SHA256 file for macOS through the shell, run this command with the desired URL, plus .sha256:

curl -LO https://fastdl.mongodb.org/osx/mongodb-macos-x86_64-7.0.6.tgz.sha256

To download the SHA256 file for Linux through the shell, run this command with the desired URL, plus .sha256:

curl -LO https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-ubuntu2204-6.0.8.tgz.sha256
3

Compute the checksum of the package file you downloaded:

shasum -c mongodb-macos-x86_64-7.0.6.tgz.sha256

which should return the following if the checksum matched the downloaded package:

mongodb-macos-x86_64-7.0.6.tgz: OK

The following procedure verifies the MongoDB binary against its SHA256 key.

1

Download the MongoDB .msi installer. For example, to download the latest version of MongoDB Community Edition:

MongoDB Community Download Center

  1. In the Version dropdown, select 7.0.6 (current release).

  2. In the Platform dropdown, select Windows.

  3. In the Package dropdown, select msi.

  4. Click Download and save the file to your Downloads folder.

2

Get the public signature file for your MongoDB version.

For example, for the SHA256 signature of the latest version of MongoDB Community Edition:

  1. From https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-7.0.6-signed.msi.sha256, copy the content.

  2. Save the content to a file mongodb-windows-x86_64-7.0.6-signed.msi.sha256 in your Downloads folder.

3

To compare the signature file to the hash of the MongoDB binary, invoke this Powershell script:

$sigHash = (Get-Content $Env:HomePath\Downloads\mongodb-windows-x86_64-7.0.6-signed.msi.sha256 | Out-String).SubString(0,64).ToUpper(); `
$fileHash = (Get-FileHash $Env:HomePath\Downloads\mongodb-windows-x86_64-7.0.6-signed.msi).Hash.Trim(); `
echo $sigHash; echo $fileHash; `
$sigHash -eq $fileHash
C777DF7816BB8C9A760FDEA782113949408B6F39D72BE29A2551FA51E2FE0473
C777DF7816BB8C9A760FDEA782113949408B6F39D72BE29A2551FA51E2FE0473
True

The command outputs three lines:

  • A SHA256 hash that you downloaded directly from MongoDB.

  • A SHA256 hash computed from the MongoDB binary you downloaded from MongoDB.

  • A True or False result depending if the hashes match.

If the hashes match, the MongoDB binary is verified.

←  Upgrade to MongoDB Enterprise (Sharded Cluster)MongoDB CRUD Operations →