Install on CentOS/Red Hat with yum
This page describes the recommended instructions for installing the latest stable version of
rippled on CentOS 7 or Red Hat Enterprise Linux 7, using Ripple's yum repository.
These instructions install a binary that has been compiled by Ripple.
Before you install
rippled, you must meet the System Requirements.
Install the Ripple RPM repository:
Choose the appropriate RPM repository for the stability of releases you want:
stablefor the latest production release (
unstablefor pre-release builds (
nightlyfor experimental/development builds (
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
cat << REPOFILE | sudo tee /etc/yum.repos.d/ripple.repo [xls20] name=xls20 baseurl=https://repos.ripple.com/repos/rippled-rpm-test-mirror/xls20 enabled=1 gpgcheck=0 repo_gpgcheck=1 gpgkey=https://repos.ripple.com/repos/rippled-rpm-test-mirror/xls20/repodata/repomd.xml.key REPOFILE
Fetch the latest repo updates:
sudo yum -y update
Install the new
sudo yum install rippled
Reload systemd unit files:
sudo systemctl daemon-reload
rippledservice to start on boot:
sudo systemctl enable rippled.service
sudo systemctl start rippled.service
It can take several minutes to sync with the rest of the XRP Ledger network, during which time the server outputs various warnings. For information about log messages, see Understanding Log Messages.
You can use the
rippled commandline interface to see if your server is synced with the network:
server_state in the response is
proposing, then your server is fully synced to the network. Otherwise, you may need to wait longer. Fresh servers usually sync within 15 minutes; servers that already have ledger history stored can take longer.
After your server has synchronized with the rest of the network, you have a fully functional XRP Ledger peer-to-peer server that you can use to submit transactions or get API access to the XRP Ledger. See Client Libraries or HTTP / WebSocket APIs for different ways to communicate with the server.
If you use the XRP Ledger for your business or you want to contribute to the stability of the network, you should run one server as a validator. For information about validating servers and why you might want to run one, see Run rippled as a Validator.
Having trouble getting your server started? See rippled Server Won't Start.
rippled should connect to the XRP Ledger with the default configuration. However, you can change your settings by editing the
rippled.cfg file. For recommendations about configuration settings, see Capacity Planning.
The recommended installation uses the config file
/etc/opt/ripple/rippled.cfg by default. Other places you can put a config file include
$HOME is the home directory of the user running
$HOME/.local/ripple/rippled.cfg, or the current working directory from where you start
rippled GitHub repository for a description of all configuration options.
You must restart
rippled for any configuration changes to take effect:
If you change the
[database_path] sections, you may need to grant ownership of the new configured path to the user you run
You must update
rippled regularly to remain synced with the rest of the XRP Ledger network. You can subscribe to the rippled Google Group to receive notifications of new
rippled package includes a script you can use to enable automatic updates on Linux. On other platforms, you must update manually.