Docs Menu
Docs Home
/
MongoDB Manual
/ / / / /

Install libmongocrypt for Queryable Encryption

On this page

  • Overview
  • macOS Installation
  • Windows Installation
  • Linux Installation
  • Debian
  • Ubuntu
  • RedHat
  • Amazon Linux 2
  • Amazon Linux
  • Suse

Learn how to install libmongocrypt, a core component of Queryable Encryption. This library performs encryption and decryption and manages communication between the driver and the Key Management System (KMS).

You do not need to install this library if it is packaged with the driver that you are using. To learn which drivers require installation of libmongocrypt, check that it is listed as a dependency in the Driver Compatibility Table.

Warning

Do not build libmongocrypt from source. Use one of the installation methods listed on this page.

brew install mongodb/brew/libmongocrypt

Click here to begin a download with the latest release binary and includes directory.

1

Import the public key used to sign the package repositories:

sudo sh -c 'curl -s --location https://pgp.mongodb.com/libmongocrypt.asc | gpg --dearmor >/etc/apt/trusted.gpg.d/libmongocrypt.gpg'
2

Add the MongoDB repository to your package sources:

Important

Change <release> in the following shell command to your platform release (e.g. "xenial" or "buster").

echo "deb https://libmongocrypt.s3.amazonaws.com/apt/debian <release>/libmongocrypt/1.8 main" | sudo tee /etc/apt/sources.list.d/libmongocrypt.list
3

Update the package cache:

sudo apt-get update
4

Install libmongocrypt:

sudo apt-get install -y libmongocrypt-dev
1

Import the public key used to sign the package repositories:

sudo sh -c 'curl -s --location https://pgp.mongodb.com/libmongocrypt.asc | gpg --dearmor >/etc/apt/trusted.gpg.d/libmongocrypt.gpg'
2

Add the MongoDB repository to your package sources:

Important

Change <release> in the following shell command to your platform release (e.g. "xenial" or "buster").

echo "deb https://libmongocrypt.s3.amazonaws.com/apt/ubuntu <release>/libmongocrypt/1.8 universe" | sudo tee /etc/apt/sources.list.d/libmongocrypt.list
3

Update the package cache:

sudo apt-get update
4

Install libmongocrypt:

sudo apt-get install -y libmongocrypt-dev
1

Create a repository file for the libmongocrypt package:

[libmongocrypt]
name=libmongocrypt repository
baseurl=https://libmongocrypt.s3.amazonaws.com/yum/redhat/$releasever/libmongocrypt/1.8/x86_64
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/libmongocrypt.asc
2

Install the libmongocrypt package:

sudo yum install -y libmongocrypt
1

Create a repository file for the libmongocrypt package:

[libmongocrypt]
name=libmongocrypt repository
baseurl=https://libmongocrypt.s3.amazonaws.com/yum/amazon/2/libmongocrypt/1.8/x86_64
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/libmongocrypt.asc
2

Install the libmongocrypt package:

sudo yum install -y libmongocrypt
1

Create a repository file for the libmongocrypt package:

[libmongocrypt]
name=libmongocrypt repository
baseurl=https://libmongocrypt.s3.amazonaws.com/yum/amazon/2013.03/libmongocrypt/1.8/x86_64
gpgcheck=1
enabled=1
gpgkey=https://pgp.mongodb.com/libmongocrypt.asc
2

Install the libmongocrypt package:

sudo yum install -y libmongocrypt
1

Import the public key used to sign the package repositories:

sudo rpm --import https://pgp.mongodb.com/libmongocrypt.asc
2

Add the repository to your package sources:

Important

Change <release> in the following shell command to your platform release (e.g. "12" or "15").

sudo zypper addrepo --gpgcheck "https://libmongocrypt.s3.amazonaws.com/zypper/suse/<release>/libmongocrypt/1.8/x86_64" libmongocrypt
3

Install the libmongocrypt package:

sudo zypper -n install libmongocrypt

Back

Automatic Encryption Shared Library for Queryable Encryption