After successfully installing the pre-built binaries,
nodeos can be run directly from the command line.
You can start your own single-node blockchain with the following command:
nodeos -e -p eosio --plugin eosio::chain_api_plugin
nodeos you should see log messages similar to below. This means blocks are successfully being produced.
1575001ms thread-0 chain_controller.cpp:235 _push_block ] initm #1 @2017-09-04T04:26:15 | 0 trx, 0 pending, exectime_ms=0 1575001ms thread-0 producer_plugin.cpp:207 block_production_loo ] initm generated block #1 @ 2017-09-04T04:26:15 with 0 trxs 0 pending 1578001ms thread-0 chain_controller.cpp:235 _push_block ] initc #2 @2017-09-04T04:26:18 | 0 trx, 0 pending, exectime_ms=0 1578001ms thread-0 producer_plugin.cpp:207 block_production_loo ] initc generated block #2 @ 2017-09-04T04:26:18 with 0 trxs 0 pending ... eosio generated block 046b9984... #101527 @ 2018-04-01T14:24:58.000 with 0 trxs eosio generated block 5e527ee2... #101528 @ 2018-04-01T14:24:58.500 with 0 trxs ...
At this point,
nodeos is running with a single producer,
The following diagram depicts the single host testnet that we just created.
cleos is used to manage the wallets, manage the accounts, and invoke actions on the blockchain. By default,
keosd is started by
cleos to perform wallet management.
The more advanced user will likely need to modify the default configuration.
nodeos uses a default configuration folder. The location of this folder is determined by your system.
- Mac OS:
The build seeds this folder with a default
genesis.json file. A configuration folder other than the default can be specified using the
--config-dir command line argument to
nodeos. If you use this option, you will need to manually copy a
genesis.json file to your config folder.
nodeos will need a properly configured
config.ini file in order to do meaningful work. On startup,
nodeos looks in the config folder for a
config.ini file. If one is not found, a default
config.ini file is created. If you do not already have a
config.ini file ready to use, run
nodeos and then close it immediately with
Ctrl-C. A default configuration (
config.ini) will have been created in the config folder. Edit the
config.ini file, adding/updating the following settings to the defaults already in place:
enable-stale-production = true producer-name = eosio plugin = eosio::producer_plugin plugin = eosio::chain_api_plugin plugin = eosio::http_plugin
Now it should be possible to simply run
nodeos without command line arguments and see it begin producing blocks.
nodeos stores runtime data (e.g., shared memory and log content) in a custom data folder. The location of this folder is determined by your system.
- Mac OS:
A different data folder than the default can be specified using the
--data-dir command line argument to