Update installation supported OSes

This commit is contained in:
mDuo13
2025-07-11 15:59:31 -07:00
parent f7de43a918
commit d6075dd033
19 changed files with 53 additions and 578 deletions

View File

@@ -8,9 +8,9 @@ labels:
---
# Install on Ubuntu or Debian Linux
This page describes the recommended instructions for installing the latest stable version of `rippled` on **Ubuntu Linux 18.04 or higher** or **Debian 10 or higher**, using the [`apt`](https://ubuntu.com/server/docs) utility.
This page describes the recommended instructions for installing the latest stable version of `rippled` on **Ubuntu Linux**, using a binary that has been compiled and published by Ripple as a `deb` package.
These instructions install a binary that has been compiled by Ripple.
Currently, **Ubuntu 22.04 and Ubuntu 24.04 on x86_64 processors** have received the highest level of support and testing. Packages are also available for **Debian Linux 12 Bookworm**. You may be able to adapt these instructions to other Linux distributions that also use the `apt` package manager, but other configurations are not officially supported.
## Prerequisites
@@ -40,7 +40,6 @@ Before you install `rippled`, you must meet the [System Requirements](system-req
sudo gpg --dearmor -o /etc/apt/keyrings/ripple.gpg
```
4. Check the fingerprint of the newly-added key:
```
@@ -56,22 +55,19 @@ Before you install `rippled`, you must meet the [System Requirements](system-req
sub rsa3072 2019-02-14 [E] [expires: 2026-02-17]
```
In particular, make sure that the fingerprint matches. (In the above example, the fingerprint is on the second line, starting with `C001`.)
5. Add the appropriate Ripple repository for your operating system version:
```
echo "deb [signed-by=/etc/apt/keyrings/ripple.gpg] https://repos.ripple.com/repos/rippled-deb focal stable" | \
echo "deb [signed-by=/etc/apt/keyrings/ripple.gpg] https://repos.ripple.com/repos/rippled-deb noble stable" | \
sudo tee -a /etc/apt/sources.list.d/ripple.list
```
The above example is appropriate for **Ubuntu 20.04 Focal Fossa**. For other operating systems, replace the word `focal` with one of the following:
The above example is appropriate for **Ubuntu 24.04 Noble Numbat**. For other operating systems, replace the word `noble` with one of the following:
- `buster` for **Debian 10 Buster**
- `bullseye` for **Debian 11 Bullseye**
- `bookworm` for **Debian 12 Bookworm**
- `bionic` for **Ubuntu 18.04 Bionic Beaver**
- `jammy` for **Ubuntu 22.04 Jammy Jellyfish**
- `noble` for **Ubuntu 24.04 Noble Numbat**
@@ -88,7 +84,6 @@ Before you install `rippled`, you must meet the [System Requirements](system-req
sudo apt -y update && sudo apt -y install rippled
```
7. Check the status of the `rippled` service:
```
@@ -101,7 +96,6 @@ Before you install `rippled`, you must meet the [System Requirements](system-req
sudo systemctl start rippled.service
```
8. Optional: allow `rippled` to bind to privileged ports.
This allows you to serve incoming API requests on port 80 or 443. (If you want to do so, you must also update the config file's port settings.)
@@ -110,7 +104,6 @@ Before you install `rippled`, you must meet the [System Requirements](system-req
sudo setcap 'cap_net_bind_service=+ep' /opt/ripple/bin/rippled
```
9. Optional: configure core dumps
By default Ubuntu is not configured to produce core files useful for debugging crashes.