Connect Your rippled to an XRPL Altnet

Ripple has created 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.

Note: The XRP Testnet and Devnet ledger and balances are reset on a regular basis.

To connect your rippled server to the XRP Testnet or Devnet, set the following configurations:

  1. In your rippled.cfg file:

    a. To connect to the Testnet, uncomment the following section and add:

    [ips]
    s.altnet.rippletest.net 51235
    

    b. To connect to the Devnet, uncomment the following section and add:

    [ips]
    s.devnet.rippletest.net 51235
    

    c. Comment out the following section, as follows:

    # [ips]
    # r.ripple.com 51235
    
  2. In your validators.txt file:

    a. Uncomment the following sections, as follows:

    [validator_list_sites]
    https://vl.altnet.rippletest.net
    
    [validator_list_keys]
    ED264807102805220DA0F312E71FC2C69E1552C9C5790F6C25E3729DEB573D5860
    

    b. Comment out the following sections, as follows:

    # [validator_list_sites]
    # https://vl.ripple.com
    #
    # [validator_list_keys]
    # ED2677ABFFD1B33AC6FBC3062B71F1E8397C1505E1C42C64D11AD1B28FF73F4734
    
  3. Restart rippled.

  4. To verify that your rippled is connected to the XRP Testnet or Devnet, use the server_info method on your server and compare it to the results from 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 command checks the latest validated ledger of a Testnet server at s.altnet.rippletest.net:

    $ ./rippled --rpc_ip 34.210.87.206:51234 server_info | grep seq
    

    The following command checks the latest validated ledger of a Devnet server at s.devnet.rippletest.net:

    $ ./rippled --rpc_ip 34.83.125.324:51234 server_info | grep seq
    

    The following command checks your local rippled's latest validated ledger sequence:

    $ ./rippled server_info | grep seq
    

See Also