ARCHIVE/xrpl-dev-portal
1
0
Fork 0
mirror of https://github.com/XRPLF/xrpl-dev-portal.git synced 2025-11-21 20:25:51 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
531ed2bc0387f99b12bc7628b3222bec3fdc898b
xrpl-dev-portal/content/tutorials/manage-the-rippled-server/install-rippled.md
mDuo13 79f2e64d17 Fix some links in complex-pay-types tuts
2018-05-11 18:40:26 -07:00

3.3 KiB
Raw Blame History

Install rippled

Production rippled instances can use Ripple's binary executable, available from the Ripple yum repository.

For development, you can compile rippled from source:

Minimum System Requirements

A rippled server should run comfortably on commodity hardware, to make it inexpensive to participate in the network. At present, we recommend the following mimimum requirements:

  • Operating System:
    • Production: CentOS or RedHat Enterprise Linux (latest release) or Ubuntu (16.04+) supported
    • Development: Mac OS X, Windows (64-bit), or most Linux distributions
  • CPU: 64-bit x86_64, 2+ cores
  • Disk: Minimum 50GB SSD recommended (1000 IOPS, more is better) for the database partition
  • RAM:
    • Testing: 8GB+
    • Production: 32 GB

Amazon EC2's m3.large VM size may be appropriate depending on your workload. A fast network connection is preferable. Any increase in a server's client-handling load increases resources needs.

Tip: For recommendations beyond the minimum requirements, see Capacity Planning.

Installation on CentOS/Red Hat with yum

This section assumes that you are using CentOS 7 or Red Hat Enterprise Linux 7.

  1. Install the Ripple RPM repository:

     $ sudo rpm -Uvh https://mirrors.ripple.com/ripple-repo-el7.rpm

  2. Install the rippled software package:

     $ sudo yum install --enablerepo=ripple-stable rippled

  3. Configure the rippled service to start on system boot:

     $ sudo systemctl enable rippled.service

  4. Start the rippled service

     $ sudo systemctl start rippled.service

Installation on Ubuntu with alien

This section assumes that you are using Ubuntu 15.04 or later.

  1. Install yum-utils and alien:

     $ sudo apt-get update
 $ sudo apt-get install yum-utils alien

  2. Install the Ripple RPM repository:

     $ sudo rpm -Uvh https://mirrors.ripple.com/ripple-repo-el7.rpm

  3. Download the rippled software package:

     $ yumdownloader --enablerepo=ripple-stable --releasever=el7 rippled

  4. Verify the signature on the rippled software package:

     $ sudo rpm --import https://mirrors.ripple.com/rpm/RPM-GPG-KEY-ripple-release && rpm -K rippled*.rpm

  5. Install the rippled software package:

     $ sudo alien -i --scripts rippled*.rpm && rm rippled*.rpm

  6. Configure the rippled service to start on system boot:

     $ sudo systemctl enable rippled.service

  7. Start the rippled service

     $ sudo systemctl start rippled.service

Postinstall

It can take several minutes for rippled to sync with the rest of the network, during which time it outputs warnings about missing ledgers. After that, you have a fully functional stock rippled server that you can use for local signing and API access to the XRP Ledger.

You can use the rippled commandline interface as follows:

$ /opt/ripple/bin/rippled <METHOD>

For a full list of available methods, see the rippled API reference.