nodeos can be configured using either the command line interface (CLI) options or a configuration file, config.ini. All the CLI options can be found by running $ nodeos --help.

Each CLI option maps to a setting in config.ini, for example --plugin eosio::chain_api_plugin can be set by adding plugin = eosio::chain_api_plugin to config.ini.

A custom config.ini file can be used by executing $ nodeos --config path/to/config.ini.

Configuration File Location

config.ini can be found at the following locations:

  • Mac OS: ~/Library/Application Support/eosio/nodeos/config
  • Linux: ~/.local/share/eosio/nodeos/config


Application Config Options:
  --plugin arg                          Plugin(s) to enable, may be specified
                                        multiple times

Application Command Line Options:
  -h [ --help ]                         Print this help message and exit.
  -v [ --version ]                      Print version information.
  --print-default-config                Print default configuration template
  -d [ --data-dir ] arg                 Directory containing program runtime
  --config-dir arg                      Directory containing configuration
                                        files such as config.ini
  -c [ --config ] arg (=config.ini)     Configuration file name relative to
  -l [ --logconf ] arg (=logging.json)  Logging configuration file name/path
                                        for library users


EOSIO Plugins often add additional configuration parameters. You can get a full list of arguments available on your install by typing nodeos -h ... The output will be dependent on the plugins you have loaded.