Install on Ubuntu with Alien
These instructions install a binary that has been compiled by Ripple.
Before you install
rippled, you must meet the System Requirements.
Install yum-utils and alien:
$ sudo apt-get update $ sudo apt-get install yum-utils alien
Install the Ripple RPM repository:
$ sudo rpm -Uvh https://mirrors.ripple.com/ripple-repo-el7.rpm
$ yumdownloader --enablerepo=ripple-stable --releasever=el7 rippled
Verify the signature on the
$ sudo rpm --import https://mirrors.ripple.com/rpm/RPM-GPG-KEY-ripple-release && rpm -K rippled*.rpm
$ sudo alien -i --scripts rippled*.rpm && rm rippled*.rpm
rippledservice to start on system boot:
$ sudo systemctl enable rippled.service
$ sudo systemctl start rippled.service
It can take several minutes for
rippled to sync with the rest of the network, during which time it outputs warnings about missing ledgers.
For information about
rippled log messages, see Understanding Log Messages.
rippled has synchronized with the rest of the network, you have a fully functional stock
rippled server that you can use for local signing and API access to the XRP Ledger. Use
rippled server states to tell whether your
rippled server has synchronized with the network. You can use the
rippled commandline interface to test this quickly:
$ /opt/ripple/bin/rippled server_info
For more information about communicating with your
rippled server using the rippled APIs, see the rippled API reference.
Once you have your stock
rippled server running, you may want to consider running it as a validating server. For information about validating servers and why you might want to run one, see Run rippled as a Validator.
Having trouble getting your
rippled 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:
$ sudo systemctl restart rippled.service
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 for Red Hat Enterprise Linux and CentOS includes a script you can use to enable automatic updates on those platforms. On other platforms, you must update manually.