Skip to main content

IOTA CLI

IOTA provides a command line interface (CLI) tool to interact with the IOTA network, its features, and the Move programming language. The complete suite of tools is called the IOTA CLI, with commands grouped together by feature. Each group of commands is commonly referred to by its top-level command: IOTA Client CLI, IOTA Console CLI, IOTA Keytool CLI, IOTA Move CLI, and IOTA Validator CLI.

Check IOTA CLI installation​

Before you can use the IOTA CLI, you must install it. To check if the CLI exists on your system, open a terminal or console and type the following command:

iota --version

If the terminal or console responds with a version number, you already have the IOTA CLI installed.

If the command is not found, follow the instructions in Install IOTA to get the IOTA CLI on your system.

Update CLI​

To get the latest version of the CLI, you can run the following command from a terminal or console. Be sure to replace <BRANCH-NAME> with develop, devnet, testnet, or mainnet to get the desired version. For more information on the branches available, see IOTA Environment Setup.

cargo install --locked --git https://github.com/iotaledger/iota.git --branch <BRANCH-NAME> --features gas-profiler iota
info

The --features gas-profiler flag is necessary only if you want to run gas profiles for transactions.

IOTA CLI commands​

There are a number of top-level commands available, to get an overview of them, use the iota help command. The six most useful commands to users are the following:

Use the help flag for the commands that are not documented yet. For example, iota validator --help.