System Specs

On AWS, we recommend using the M6i, R6i, or C6i series.

Ports

Ensure all ports needed for your node functionality are needed, described below

• story-geth
  • 8545
    • Required if you want your node to interface via JSON-RPC API over HTTP
  • 8546
    • Required for websockets interaction
  • 30303 (TCP + API)
    • MUST be open for p2p communication
• story
  • 26656
    • MUST be open for consensus p2p communication
  • 26657
    • Required if you want your node interfacing for Tendermint RPC
  • 26660
    • Needed if you want to expose prometheus metrics

Default Folder

By default, we setup the following default data folders for consensus and execution clients:

• Mac OS X
  • story data root: ~/Library/Story/story
  • story-geth data root: ~/Library/Story/geth
• Linux
  • story data root: ~/.story/story
  • story-geth data root: ~/.story/geth

For the remainder of this tutorial, we will refer to the story data root as ${STORY_DATA_ROOT} and the geth data root as ${GETH_DATA_ROOT}.

You are able to override these configs on the story client side by passing --home ${STORY_CONFIG_FOLDER}. Similarly, for geth, you may use --config ${GETH_CONFIG_FOLDER}. For information on how overrides work, view our readme on setting up a private network.

Execution Client Setup (story-geth)

1. (Mac OS X only) The OS X binaries have yet to be signed by our build process, so you may need to unquarantine them manually:

   sudo xattr -rd com.apple.quarantine ./geth

2. You may now run geth with the following command:

   ./geth --iliad --syncmode full

   • Currently, snap sync mode, the default, is still undergoing development

Clear State

If you ever run into issues and would like to try joining the network from a cleared state, run the following:

rm -rf ${GETH_DATA_ROOT} && ./geth --iliad --syncmode full