Skip to content

connect.md

Latest commit

 

History

History
executable file
·
71 lines (48 loc) · 1.69 KB

connect.md

File metadata and controls

executable file
·
71 lines (48 loc) · 1.69 KB
Raw
title net connect
tags
clio
net
p2p

Command

clio net connect <host> [OPTIONS]

Description

Start a new connection to a specified peer. A node operator can use this command to instruct a node to connect to another peer without restarting the node.

Synopsis

clio net connect
  <host>                           # REQUIRED: The hostname:port of the peer to connect to
  [-h | --help]                    # Print this help message and exit

Requirements

Make sure you meet the following requirements:

  • Install the currently supported version of clio.

:::note The clio tool is bundled with the Wire software. Installing Wire core will install the clio and kiod command line tools. :::

  • You have access to a producing node instance with the net_api_plugin loaded.

Examples

The following examples demonstrate how to use the clio net connect command:

  • Instruct default local node (listening at default http address http://127.0.0.1:8887) to connect to peer node listening at p2p address devnet-0:4444 (where devnet-0 is mapped to 123.456.78.90 in /etc/hosts):
clio net connect devnet-0:4444

Output:

"added connection"
  • Instruct local node listening at http address http://127.0.0.1:8887 to connect to peer node listening at p2p address devnet-0:4444:
clio -u http://127.0.0.1:8887 net connect devnet-0:4444

Output:

"added connection"

Note: If any of the above commands are re-executed, clio returns the following message as expected:

"already connected"