mirror of
https://github.com/XRPLF/xrpl-dev-portal.git
synced 2025-11-26 14:45:50 +00:00
84 lines
3.0 KiB
Markdown
84 lines
3.0 KiB
Markdown
# Install rippled
|
|
|
|
For development, you can [compile `rippled` from source](https://wiki.ripple.com/Rippled_build_instructions).
|
|
|
|
Production `rippled` instances can [use Ripple's binary executable](#installation-on-centosred-hat-with-yum), available from the Ripple [yum](https://en.wikipedia.org/wiki/Yellowdog_Updater,_Modified) repository.
|
|
|
|
## 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](#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.
|
|
|
|
[rippled commands](reference-rippled.html#list-of-public-commands) can be run with:
|
|
|
|
$ /opt/ripple/bin/rippled <command>
|