Run genesis locally

iota start --network.config <working_directory>

Start a local network in two modes: saving state between re-runs and not saving state between re-runs. By default, iota start will start a local network from the genesis blob that exists in the IOTA config default dir or in the config_dir that was passed. If the default directory does not exist and the config_dir is not passed, it will generate a new default directory, generate the genesis blob (without migration), and start the network. Note that if you want to start an indexer, Postgres DB is required.

Command flags:

  • (Optional)--config-dir aliased as - network.config: сonfig directory that will be used to store network config, node db, keystore.
  • (Optional)--force-regenesis: a flag used to generates new genesis is created each time this flag is set, and state is not persisted between runs. Only use this flag when you want to start the network from scratch every time you run this command. To run with persisted state, do not pass this flag and use the iota genesis command to generate a genesis that can be used to start the network with.
  • (Optional)--with-faucet: starts a faucet with default host and port: 0.0.0.0:9123. When providing a specific value, please use the = sign between the flag and value: --with-faucet=6124 or --with-faucet=0.0.0.0, or --with-faucet=0.0.0.0:9123.
  • (Optional)--faucet-amount: set the amount of nanos that the faucet will put in an object. 200 IOTA is default value.
  • (Optional)--indexer-feature-args: enabling indexer-related features (like the indexer, GraphQL hosts, and PostgreSQL) only works if the indexer feature is enabled.
  • (Optional)--fullnode-rpc-port: port to start the Fullnode RPC server on. Default port is 9000.
  • (Optional)--epoch-duration-ms: set the epoch duration. Can only be used when --force-regenesis flag is passed or if there's no genesis config and one will be auto-generated. When this flag is not set but --force-regenesis is set, the epoch duration will be set to 60 seconds.
  • (Optional)--no-full-node: a flag used to starts the network without a fullnode.
  • (Optional)--committee-size: used to set the number of validators in the network. If a genesis was already generated with a specific number of validators, this will not override it; the user should recreate the genesis with the desired number of validators.
  • (Optional)--local-migration-snapshots: the path to local migration snapshot files.
  • (Optional)--remote-migration-snapshots: the path to remote migration snapshot files. A remote snapshot is one that is downloaded from the specified URL, e.g. https://api.devnet.iota.cafe. Is required to use this flag when you have use a local/remote migration snapshot.
  • (Optional)--delegator: the delegator is an existing address on the old network that holds IF funds which will be partially used for the genesis distribution of validator stakes and gas tokens on the new network.