How To Connect To A Specific Keosd


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

The example uses the wallet-url optional arguments to request data from the specified keosd instance.

Default address:port

If no optional arguments are used (i.e. no --wallet-url), cleos attempts to connect to a local nodeos or keosd running at localhost or and default port 8900. Use the keosd 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 and keosd.


    Cleos and keosd are bundled with the EOSIO software. Installing EOSIO will also install the cleos and keosd comand line tools.

  • You have access to a a local keosd instance and the http address and port number of the local keosd instance.


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


  1. Add the --wallet-url option to a command
cleos --wallet-url http://keosd-host:8900 COMMAND


  • --wallet-url http://keosd-host:8900 = The http address and port number of the keosd instance.
  • COMMAND = The cleos command to run.


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