Skip to content

Latest commit

 

History

History
104 lines (75 loc) · 4.12 KB

start.md

File metadata and controls

104 lines (75 loc) · 4.12 KB

symbol-bootstrap start

Single command that aggregates config, compose and run in one line!

symbol-bootstrap start

Single command that aggregates config, compose and run in one line!

USAGE
  $ symbol-bootstrap start

OPTIONS
  -a, --assembly=assembly
      The assembly that defines the node(s) layout. It can be provided via custom preset or cli parameter. If not
      provided, the value is resolved from the target/preset.yml file. Options are: dual, peer, api, demo, multinode,
      services, my-custom-assembly.yml (advanced).

  -b, --build
      If provided, docker-compose will run with -b (--build)

  -c, --customPreset=customPreset
      External preset file. Values in this file will override the provided presets.

  -d, --detached
      If provided, docker-compose will run with -d (--detached) and this command will wait unit server is running before
      returning

  -h, --help
      It shows the help of this command.

  -p, --preset=preset
      The network preset. It can be provided via custom preset or cli parameter. If not provided, the value is resolved
      from the target/preset.yml file. Options are: bootstrap, testnet, mainnet, my-custom-network.yml (advanced, only for
      custom networks).

  -r, --reset
      It resets the configuration generating a new one.

  -t, --target=target
      [default: target] The target folder where the symbol-bootstrap network is generated

  -u, --user=user
      [default: current] User used to run docker images when creating configuration files like certificates or nemesis
      block. "current" means the current user.

  --args=args
      Add extra arguments to the docker-compose up command. Check out https://docs.docker.com/compose/reference/up.

  --healthCheck
      It checks if the services created with docker compose are up and running.

      This command checks:
      - Whether the docker containers are running.
      - Whether the services' exposed ports are listening.
      - Whether the rest gateways' /node/health are OK.

      The health check process handles 'repeat' and custom 'openPort' services.

  --logger=logger
      [default: Console,File] The loggers the command will use. Options are: Console,File,Silent. Use ',' to select
      multiple loggers.

  --noPassword
      When provided, Bootstrap will not use a password, so private keys will be stored in plain text. Use with caution.

  --offline
      If --offline is used, Bootstrap resolves the configuration without querying the running network.

  --password=password
      A password used to encrypt and decrypt private keys in preset files like addresses.yml and preset.yml. Bootstrap
      prompts for a password by default, can be provided in the command line (--password=XXXX) or disabled in the command
      line (--noPassword).

  --pullImages
      It pulls the images from DockerHub when running the configuration. It only affects alpha/dev docker images.

  --report
      It generates reStructuredText (.rst) reports describing the configuration of each node.

  --resetData
      It reset the database and node data but keeps the generated configuration, keys, voting tree files and block 1

  --timeout=timeout
      [default: 60000] If running in detached mode, how long before timing out (in milliseconds)

  --upgrade
      It regenerates the configuration reusing the previous keys. Use this flag when upgrading the version of bootstrap to
      keep your node up to date without dropping the local data. Backup the target folder before upgrading.

EXAMPLES
  $ symbol-bootstrap start -p bootstrap
  $ symbol-bootstrap start -p testnet -a dual
  $ symbol-bootstrap start -p mainnet -a peer -c custom-preset.yml
  $ symbol-bootstrap start -p testnet -a dual --password 1234
  $ symbol-bootstrap start -p mainnet -a my-custom-assembly.yml -c custom-preset.yml
  $ symbol-bootstrap start -p my-custom-network.yml -a dual -c custom-preset.yml
  $ echo "$MY_ENV_VAR_PASSWORD" | symbol-bootstrap start -p testnet -a dual

See code: src/commands/start.ts