Database Manual / Security / Encryption / In-Use Encryption / Client-Side Field Level Encryption / Reference

Install libmongocrypt for CSFLE

Overview

Learn how to install libmongocrypt, a core component of Client-Side Field Level Encryption.

Warning

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

macOS Installation

brew install mongodb/brew/libmongocrypt

Windows Installation

Click here to see the latest libmongocrypt release.

Use gpg to verify the signature. The public key for libmongocrypt is available here.

Linux Installation

Debian

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.16 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

Ubuntu

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.16 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

RedHat

1

Create a repository file for the libmongocrypt package:

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

Install the libmongocrypt package:

sudo yum install -y libmongocrypt

Amazon Linux 2

1

Create a repository file for the libmongocrypt package:

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

Install the libmongocrypt package:

sudo yum install -y libmongocrypt

Amazon Linux 2023

1

Create a /etc/yum.repos.d/libmongocrypt.repo repository file:

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

Install the libmongocrypt package:

sudo yum install -y libmongocrypt

Amazon Linux

1

Create a /etc/yum.repos.d/libmongocrypt.repo repository file:

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

Install the libmongocrypt package:

sudo yum install -y libmongocrypt

Suse

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.16/x86_64" libmongocrypt
3

Install the libmongocrypt package:

sudo zypper -n install libmongocrypt