Files
xrpl-dev-portal/docs/infrastructure/installation/install-rippled-on-rhel.md
2025-07-11 15:59:31 -07:00

3.3 KiB

seo, labels
seo labels
description
Install a precompiled rippled binary on Red Hat Enterprise Linux.
Core Server

Install on Red Hat Enterprise Linux

This page describes the recommended instructions for installing the latest stable version of rippled on Red Hat Enterprise Linux, using a binary that has been compiled and published by Ripple as an rpm package.

Currently, Red Hat Enterprise Linux (RHEL) 9.6 is supported on x86_64 processors. You may also be able to adapt these instructions to similar Linux distributions including CentOS or Rocky Linux, but other configurations are not officially supported.

Prerequisites

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

Installation Steps

  1. Install the Ripple RPM repository:

    Choose the appropriate RPM repository for the stability of releases you want:

    • stable for the latest production release (master branch)
    • unstable for pre-release builds (release branch)
    • nightly for experimental/development builds (develop branch)

    {% tabs %}

    cat << REPOFILE | sudo tee /etc/yum.repos.d/ripple.repo
    [ripple-stable]
    name=XRP Ledger Packages
    enabled=1
    gpgcheck=0
    repo_gpgcheck=1
    baseurl=https://repos.ripple.com/repos/rippled-rpm/stable/
    gpgkey=https://repos.ripple.com/repos/rippled-rpm/stable/repodata/repomd.xml.key
    REPOFILE
    
    cat << REPOFILE | sudo tee /etc/yum.repos.d/ripple.repo
    [ripple-unstable]
    name=XRP Ledger Packages
    enabled=1
    gpgcheck=0
    repo_gpgcheck=1
    baseurl=https://repos.ripple.com/repos/rippled-rpm/unstable/
    gpgkey=https://repos.ripple.com/repos/rippled-rpm/unstable/repodata/repomd.xml.key
    REPOFILE
    
    cat << REPOFILE | sudo tee /etc/yum.repos.d/ripple.repo
    [ripple-nightly]
    name=XRP Ledger Packages
    enabled=1
    gpgcheck=0
    repo_gpgcheck=1
    baseurl=https://repos.ripple.com/repos/rippled-rpm/nightly/
    gpgkey=https://repos.ripple.com/repos/rippled-rpm/nightly/repodata/repomd.xml.key
    REPOFILE
    

    {% /tabs %}

  2. Fetch the latest repo updates:

    sudo yum -y update
    
  3. Install the new rippled package:

    sudo yum install rippled
    
  4. Reload systemd unit files:

    sudo systemctl daemon-reload
    
  5. Configure the rippled service to start on boot:

    sudo systemctl enable rippled.service
    
  6. Start the rippled service:

    sudo systemctl start rippled.service
    

Next Steps

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

See Also

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