xrpl-dev-portal/content/infrastructure/configuration/peering/manually-connect-to-a-specific-peer.md

html, parent, blurb, labels

html	parent	blurb	labels
manually-connect-to-a-specific-peer.html	configure-peering.html	Connect your rippled server to a specific peer.	Core Server

Manually Connect to a Specific Peer

Use these steps to manually connect your server to a specific peer in the XRP Ledger network.

Tip: If you want to make sure your server automatically connects to this server on startup and remains connected later, you may want to configure a peer reservation for that peer.

Prerequisites

• You must know the IP address of the peer you want to connect to.
• You must know what port the peer you want to connect to uses for the XRP Ledger peer protocol. The default config file uses port 51235.
• You must have a network connection from your server to the peer. For example, the peer server must forward the appropriate port through its firewall.
• The peer server must have available peer slots. If the peer is already at its maximum number of peers, you can ask the peer server's operator to add a peer reservation for your server.

Steps

To connect, use the [connect method][]. For example:

{% tabs %}

{% tab label="WebSocket" %}

{
    "command": "connect",
    "ip": "169.54.2.151",
    "port": 51235
}

{% /tab %}

{% tab label="JSON-RPC" %}

{
    "method": "connect",
    "params": [
        {
            "ip": "169.54.2.151",
            "port": 51235
        }
    ]
}

{% /tab %}

{% tab label="Commandline" %}

rippled connect 169.54.2.151 51235

{% /tab %}

{% /tabs %}

See Also

• Concepts:
  • Peer Protocol
  • The rippled Server
• Tutorials:
  • Capacity Planning
  • Troubleshoot the rippled Server
• References:
  • [connect method][]
  • [peers method][]
  • [print method][]
  • [server_info method][]

{% raw-partial file="/_snippets/common-links.md" /%}