Connect Your rippled to a Parallel Network

Ripple hosts alternative test and development networks for developers to test their apps on the latest non-production version of the XRP Ledger (Testnet) or to test and experiment with features on the latest beta version (Devnet). The funds used on these networks are not real funds and are intended for testing only. You can connect your rippled server to either the Testnet or Devnet.

Caution: The Devnet frequently has new and experimental amendments enabled, so the latest production release version is likely to be amendment blocked when connecting to Devnet. You should use a pre-release or nightly build when connecting to Devnet.

Steps

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.

Edit your rippled.cfg file.

The recommended installation uses the config file /etc/opt/ripple/rippled.cfg by default. Other places you can put a config file include $HOME/.config/ripple/rippled.cfg (where $HOME is the home directory of the user running rippled), $HOME/.local/ripple/rippled.cfg, or the current working directory from where you start rippled.

  1. Set an [ips] stanza with the hub for the network you want to connect to:

    [ips]
s.altnet.rippletest.net 51235

    [ips]
s.devnet.rippletest.net 51235

    # No [ips] stanza. Use the default hubs to connect to Mainnet.

  2. Comment out the previous [ips] stanza, if there is one:

    # [ips]
# r.ripple.com 51235
# zaphod.alloy.ee 51235
# sahyadri.isrdc.in 51235

2. Set your trusted validator list.

Edit your 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.

  1. Uncomment or add the [validator_list_sites] and [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

  2. Comment out any previous [validator_list_sites], [validator_list_keys], or [validators] stanzas.

    For example:

        # [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. (Devnet Only) Enable Features

To connect to Devnet, you must also forcefully enable any experimental features that are currently in testing on Devnet. Add or modify the [features] stanza of your config file as follows:

[features]
NegativeUNL

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 35.158.96.209:51234 server_info | grep seq

# s.devnet.rippletest.net
$ rippled --rpc_ip 34.83.125.234:51234 server_info | grep seq

# s1.ripple.com
$ rippled --rpc_ip 34.201.59.230: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 dig command.

See Also