How To Connect To A Specific Network


This guide provides instructions on how to connect to specifc EOSIO blockchain when using cleos. Cleos can connect to a specific node by using the --url optional argument, followed by the http address and port number.

The examples use the --urloptional argument to send commands to the specified blockchain.

Default address:port

If no optional arguments are used (i.e. no --url), cleos attempts to connect to a local nodeos running at localhost or and default port 8888. Use the nodeos command line arguments or config.ini file to specify a different address.

Before you Begin

Make sure you meet the following requirements:

  • Install the currently supported version of cleos.


    Cleos is bundled with the EOSIO software. Installing EOSIO will install the cleos and keosd command line tools.

  • You have access to an EOSIO blockchain and the http afddress and port number of a nodeos instance.


See the following reference guides for command line usage and related options:


  1. Add the -url option to specify the nodeos instance
cleos -url http://nodeos-host:8888 COMMAND


  • -url http://nodeos-host:8888 = The http address and port number of the nodeos instance to connect to
  • COMMAND = The cleoscommand.


In conclusion, by following these instructions you are able to connect to a specified nodeos instance.