xrpl-dev-portal/docs/infrastructure/installation/install-rippled-on-ubuntu.md

html, parent, seo, labels

html	parent	seo	labels
install-rippled-on-ubuntu.html	install-rippled.html	description Install a precompiled rippled binary on Ubuntu Linux.	Core Server

Install on Ubuntu or Debian Linux

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.

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

Before you install rippled, you must meet the System Requirements.

Installation Steps

1. Update repositories:

   sudo apt -y update
   

2. Install utilities:

   sudo apt -y install apt-transport-https ca-certificates wget gnupg
   

3. Add Ripple's package-signing GPG key to your list of trusted keys:

   sudo install -m 0755 -d /etc/apt/keyrings && \
       wget -qO- https://repos.ripple.com/repos/api/gpg/key/public | \
       sudo gpg --dearmor -o /etc/apt/keyrings/ripple.gpg
   

4. Check the fingerprint of the newly-added key:

   gpg --show-keys /etc/apt/keyrings/ripple.gpg
   

   The output should include an entry for Ripple such as the following:

   pub   rsa3072 2019-02-14 [SC] [expires: 2026-02-17]
       C0010EC205B35A3310DC90DE395F97FFCCAFD9A2
   uid           TechOps Team at Ripple <techops+rippled@ripple.com>
   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 noble stable" | \
       sudo tee -a /etc/apt/sources.list.d/ripple.list
   

   The above example is appropriate for Ubuntu 24.04 Noble Numbat. For other operating systems, replace the word noble with one of the following:

   • bullseye for Debian 11 Bullseye
   • bookworm for Debian 12 Bookworm
   • jammy for Ubuntu 22.04 Jammy Jellyfish
   • noble for Ubuntu 24.04 Noble Numbat

   If you want access to development or pre-release versions of rippled, use one of the following instead of stable:

   • unstable - Pre-release builds (release branch)
   • nightly - Experimental/development builds (develop branch)

   {% admonition type="danger" name="Warning" %}Unstable and nightly builds may be broken at any time. Do not use these builds for production servers.{% /admonition %}

6. Update the package index to include Ripple's repo and install rippled.

   sudo apt -y update && sudo apt -y install rippled
   

7. Check the status of the rippled service:

   systemctl status rippled.service
   

   The rippled service should start automatically. If not, you can start it manually:

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

   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. First run:

   ulimit -c unlimited
   

   Now run sudo systemctl edit rippled. The default editor should open and add

   [Service]
   LimitCORE=infinity
   

   This creates the file /etc/systemd/system/rippled.service.d/override.conf and configures the OS to save core dumps, without changing the service file provided by the rippled package. If your server crashes, you can find the core dump in /var/lib/apport/coredump/. To load the core dump for inspection, use a command such as the following:

   gdb /opt/ripple/bin/rippled /var/lib/apport/coredump/core
   

   {% admonition type="info" name="Note" %}To debug a core file this way, you must have the rippled-dbgsym package installed, and you need permission to read files in the core dump directory.{% /admonition %}

Next Steps

{% partial file="/docs/_snippets/post-rippled-install.md" /%}

See Also

• Concepts:
  • The rippled Server
  • Consensus
• Tutorials:
  • Configure rippled
  • Troubleshoot rippled
  • Get Started with the rippled API
• References:
  • rippled API Reference
    • rippled Commandline Usage
    • [server_info method][]

{% raw-partial file="/docs/_snippets/common-links.md" /%}