Home/Networks/XRP Ledger

xrpl

How to install XRP Ledger full node

Install rippled (xrpld) as a self-hosted XRP Ledger full node on your server. This guide covers the agent, network selection, setup, and sync.

Client

rippled (xrpld)

RPC

rippled JSON-RPC / WebSocket

History

complete_ledgers from genesis (32570 mainnet, 1 testnet) — not a short window.

Stock rippled can look healthy while history is a thin window. On Install you pick how much history to keep: stock (~2h), 1 day, 2 weeks (default), or full genesis→tip (~39 TiB, no public snapshot). Synced is complete_ledgers covering that window (32570 on mainnet for full).

Mainnet and testnet are separate envs. After start, Node Config edits xrpld cfg. Clio is not required day one — clients still hit the Go proxy.

Environments

mainnettestnet

How to install XRP Ledger node

Choose mainnet, testnet in Toolkit, then follow these steps to provision and run a XRP Ledger full node.

  1. Install the panel and host agent using the documentation, then register the server in the panel.
  2. In Add node, select XRP Ledger and the required environment.
  3. Review the network options, start provisioning, and follow sync status and logs from the node page.

Operate from the panel

After the node is up you manage it in the same UI — Node Config (edit the live files and apply), client updates, restart, logs, public RPC. You do not need SSH to change conf. Install-time choices (snapshot flavor, history window, disk layout) are stored on that node.

FAQ

How do I install XRP Ledger full node?
Install the host agent, add the server, then choose XRP Ledger and an environment in Add node. Toolkit provisions rippled (xrpld) and tracks sync from the panel.
Can I change the XRP Ledger config later?
Yes. Node page → Node Config. Edit and apply; restart from the same page. A different snapshot or history flavor is an Install choice — changing it later usually means wipe and Add node again.
Pruned or light?
complete_ledgers from genesis (32570 mainnet, 1 testnet) — not a short window.

Other networks