Connect Your rippled to a Parallel Network
Various alternative test and development networks exist for developers to test their apps or experiment with features without risking real money. The funds used on these networks are not real funds and are intended for testing only. You can connect your
rippled server to any of these test networks.
Caution: On test networks with new and experimental features, you may need to run a pre-production release of the server to sync with the network. See the Parallel Networks Page for information on what code version each network needs.
To connect your
rippled server to the XRP Testnet or Devnet, complete these steps. You can also use these steps to switch back to the production Mainnet after being on the Testnet or Devnet.
1. Configure your server to connect to the right hub.
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
[ips]stanza with the hub for the network you want to connect to:
Comment out the previous
[ips]stanza, if there is one:
# [ips] # r.ripple.com 51235 # zaphod.alloy.ee 51235 # sahyadri.isrdc.in 51235
[network_id]stanza with the appropriate value:
Note: This setting is optional, and does not strictly define which network your server follows, but it helps servers find peers who are following the same network.
2. Set your trusted validator list.
validators.txt file. This file is located in the same folder as your
rippled.cfg file and defines which validators your server trusts not to collude.
Uncomment or add the
[validator_list_keys]stanzas for the network you want to connect to:
[validator_list_sites] https://vl.altnet.rippletest.net [validator_list_keys] ED264807102805220DA0F312E71FC2C69E1552C9C5790F6C25E3729DEB573D5860
[validator_list_sites] https://vl.devnet.rippletest.net [validator_list_keys] EDDF2F53DFEC79358F7BE76BC884AC31048CFF6E2A00C628EAE06DB7750A247B12
[validator_list_sites] https://vl.ripple.com [validator_list_keys] ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734
[validator_list_sites] http://nftvalidators.s3.us-west-2.amazonaws.com/index.json [validator_list_keys] ED8E43A943A174190BA2FAE91F44AC6E2D1D8202EFDCC2EA3DBB39814576D690F7
Tip: The packages for the NFT preview should already contain the necessary stanzas, but check them just in case.
Comment out any previous
# [validator_list_sites] # https://vl.ripple.com # # [validator_list_keys] # ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734 # Old hard-coded List of Devnet Validators # [validators] # n9Mo4QVGnMrRN9jhAxdUFxwvyM4aeE1RvCuEGvMYt31hPspb1E2c # n9MEwP4LSSikUnhZJNQVQxoMCgoRrGm6GGbG46AumH2KrRrdmr6B # n9M1pogKUmueZ2r3E3JnZyM3g6AxkxWPr8Vr3zWtuRLqB7bHETFD # n9MX7LbfHvPkFYgGrJmCyLh8Reu38wsnnxA4TKhxGTZBuxRz3w1U # n94aw2fof4xxd8g3swN2qJCmooHdGv1ajY8Ae42T77nAQhZeYGdd # n9LiE1gpUGws1kFGKCM9rVFNYPVS4QziwkQn281EFXX7TViCp2RC # n9Jq9w1R8UrvV1u2SQqGhSXLroeWNmPNc3AVszRXhpUr1fmbLyhS
3. (NFT-Devnet Only) Enable Features
To connect to the NFT-Devnet, you must also forcefully enable the NFT feature,
XLS20. Add or modify the
[features] stanza of your config file as follows:
Warning: Do not use the
[features] stanza when connecting to Mainnet or Testnet. Forcefully enabling different features than the rest of the network could cause your server to diverge from the network.
4. Restart the server.
$ sudo systemctl restart rippled
5. Verify that your server syncs.
It takes about 5 to 15 minutes to sync to the network after a restart. After your server is synced, the server_info method shows the a
validated_ledger object based on the network you are connected to.
To verify that your
rippled is connected to the XRP Testnet or Devnet, compare the results from your server to a public server on the Testnet or Devnet. The
seq field of the
validated_ledger object should be the same on both servers (possibly off by one or two, if it changed as you were checking).
The following example shows how to check the latest validated ledger from the commandline:
rippled server_info | grep seq
# s.altnet.rippletest.net rippled --rpc_ip 184.108.40.206:51234 server_info | grep seq
# s.devnet.rippletest.net rippled --rpc_ip 220.127.116.11:51234 server_info | grep seq
# s1.ripple.com rippled --rpc_ip 18.104.22.168:51234 server_info | grep seq
# xls20-sandbox.rippletest.net rippled --rpc_ip 22.214.171.124:51234 server_info | grep seq
Note: The IP addresses in these examples are for public servers, and may change periodically. If you get no response, look up the IP address of a public server, for example using the