Skip to content

Commit aa8bb14

Browse files
committed
MONGOCRYPT-192 document package installation from PPAs
1 parent f602d75 commit aa8bb14

File tree

1 file changed

+115
-0
lines changed

1 file changed

+115
-0
lines changed

README.md

+115
Original file line numberDiff line numberDiff line change
@@ -110,3 +110,118 @@ Do the following when releasing:
110110
- Commit, create a new git tag, like `1.0.0-rc123`, and push.
111111
- In the Java binding build.gradle.kts, replace `version = "1.0.0-rc123"` with `version = "1.0.0-SNAPSHOT"` (i.e. undo the change). For an example of this, see [this commit](https://github.com/mongodb/libmongocrypt/commit/2336123fbc1f4f5894f49df5e6320040987bb0d3) and its parent commit.
112112
- Commit and push.
113+
114+
## Installing libmongocrypt From Distribution Packages ##
115+
Distribution packages (i.e., .deb/.rpm) are built and published for several Linux distributions. The installation of these packages for supported platforms is documented here.
116+
117+
### .deb Packages (Debian and Ubuntu) ###
118+
119+
First, import the public key used to sign the package repositories:
120+
121+
```
122+
sudo sh -c 'curl -s https://www.mongodb.org/static/pgp/libmongocrypt.asc | gpg --dearmor >/etc/apt/trusted.gpg.d/libmongocrypt.gpg'
123+
```
124+
125+
Second, create a list entry for the repository. For Ubuntu systems (be sure to change `<release>` to `xenial` or `bionic`, as appropriate to your system):
126+
127+
```
128+
echo "deb https://libmongocrypt.s3.amazonaws.com/apt/ubuntu <release>/libmongocrypt/1.0 universe" | sudo tee /etc/apt/sources.list.d/libmongocrypt.list
129+
```
130+
131+
For Debian systems (be sure to change `<release>` to `stretch` or `buster`, as appropriate to your system):
132+
133+
```
134+
echo "deb https://libmongocrypt.s3.amazonaws.com/apt/debian <release>/libmongocrypt/1.0 main" | sudo tee /etc/apt/sources.list.d/libmongocrypt.list
135+
```
136+
137+
Third, update the package cache:
138+
139+
```
140+
sudo apt-get update
141+
```
142+
143+
Finally, install the libmongocrypt packages:
144+
145+
```
146+
sudo apt-get install -y libmongocrypt-dev
147+
```
148+
149+
### .rpm Packages (RedHat, Suse, and Amazon) ###
150+
151+
152+
#### RedHat Enterprise Linux ####
153+
154+
Create the file `/etc/yum.repos.d/libmongocrypt.repo` with contents:
155+
156+
```
157+
[libmongocrypt]
158+
name=libmongocrypt repository
159+
baseurl=https://libmongocrypt.s3.amazonaws.com/yum/redhat/$releasever/libmongocrypt/1.0/x86_64
160+
gpgcheck=1
161+
enabled=1
162+
gpgkey=https://www.mongodb.org/static/pgp/libmongocrypt.asc
163+
```
164+
165+
Then install the libmongocrypt packages:
166+
167+
```
168+
sudo yum install -y libmongocrypt
169+
```
170+
171+
#### Amazon Linux 2 ####
172+
173+
Create the file `/etc/yum.repos.d/libmongocrypt.repo` with contents:
174+
175+
```
176+
[libmongocrypt]
177+
name=libmongocrypt repository
178+
baseurl=https://libmongocrypt.s3.amazonaws.com/yum/amazon/2/libmongocrypt/1.0/x86_64
179+
gpgcheck=1
180+
enabled=1
181+
gpgkey=https://www.mongodb.org/static/pgp/libmongocrypt.asc
182+
```
183+
184+
Then install the libmongocrypt packages:
185+
186+
```
187+
sudo yum install -y libmongocrypt
188+
```
189+
190+
#### Amazon Linux ####
191+
192+
Create the file `/etc/yum.repos.d/libmongocrypt.repo` with contents:
193+
194+
```
195+
[libmongocrypt]
196+
name=libmongocrypt repository
197+
baseurl=https://libmongocrypt.s3.amazonaws.com/yum/amazon/2013.03/libmongocrypt/1.0/x86_64
198+
gpgcheck=1
199+
enabled=1
200+
gpgkey=https://www.mongodb.org/static/pgp/libmongocrypt.asc
201+
```
202+
203+
Then install the libmongocrypt packages:
204+
205+
```
206+
sudo yum install -y libmongocrypt
207+
```
208+
209+
#### Suse ####
210+
211+
First, import the public key used to sign the package repositories:
212+
213+
```
214+
sudo rpm --import https://www.mongodb.org/static/pgp/libmongocrypt.asc
215+
```
216+
217+
Second, add the repository (be sure to change `<release>` to `12` or `15`, as appropriate to your system):
218+
219+
```
220+
sudo zypper addrepo --gpgcheck "https://libmongocrypt.s3.amazonaws.com/zypper/suse/<release>/libmongocrypt/1.0/x86_64" libmongocrypt
221+
```
222+
223+
Finally, install the libmongocrypt packages:
224+
225+
```
226+
sudo zypper -n install libmongocrypt
227+
```

0 commit comments

Comments
 (0)