Skip to content
Joseph Tran

Installation

Story banner

System Specs

HardwareRequirement
CPU4 Cores
RAM8 GB
Disk200 GB
Bandwidth10 MBit/s

https://docs.story.foundation/docs/node-setup

Install dependencies

Terminal window
sudo apt update
sudo apt-get update
sudo apt install curl git make jq build-essential gcc unzip wget lz4 aria2 -y

Download Story-Geth binary v0.9.4

Terminal window
cd $HOME
wget https://github.com/piplabs/story-geth/releases/download/v0.9.4/geth-linux-amd64
[ ! -d "$HOME/go/bin" ] && mkdir -p $HOME/go/bin
if ! grep -q "$HOME/go/bin" $HOME/.bash_profile; then
  echo "export PATH=$PATH:/usr/local/go/bin:~/go/bin" >> ~/.bash_profile
fi
chmod +x geth-linux-amd64
mv $HOME/geth-linux-amd64 $HOME/go/bin/story-geth
source $HOME/.bash_profile
story-geth version
banner

Download Story binary v0.11.0

Terminal window
cd $HOME
wget https://story-geth-binaries.s3.us-west-1.amazonaws.com/story-public/story-linux-amd64-0.11.0-aac4bfe.tar.gz
tar -xzvf story-linux-amd64-0.11.0-aac4bfe.tar.gz
[ ! -d "$HOME/go/bin" ] && mkdir -p $HOME/go/bin
if ! grep -q "$HOME/go/bin" $HOME/.bash_profile; then
  echo "export PATH=$PATH:/usr/local/go/bin:~/go/bin" >> ~/.bash_profile
fi
sudo cp $HOME/story-linux-amd64-0.11.0-aac4bfe/story $HOME/go/bin
source $HOME/.bash_profile
story version
banner

Init Iliad node

Terminal window
story init --network iliad --moniker "Your_moniker_name"
banner

Create story-geth service file

Terminal window
sudo tee /etc/systemd/system/story-geth.service > /dev/null <<EOF
[Unit]
Description=Story Geth Client
After=network.target


[Service]
User=root
ExecStart=/root/go/bin/story-geth --iliad --syncmode full
Restart=on-failure
RestartSec=3
LimitNOFILE=4096


[Install]
WantedBy=multi-user.target
EOF

Create story service file

Terminal window
sudo tee /etc/systemd/system/story.service > /dev/null <<EOF
[Unit]
Description=Story Consensus Client
After=network.target


[Service]
User=root
ExecStart=/root/go/bin/story run
Restart=on-failure
RestartSec=3
LimitNOFILE=4096


[Install]
WantedBy=multi-user.target
EOF

Use snapshot

Terminal window
cd $HOME
rm -f Story_snapshot.lz4
aria2c -x 16 -s 16 -k 1M https://story.josephtran.co/Story_snapshot.lz4
Terminal window
rm -f Geth_snapshot.lz4
aria2c -x 16 -s 16 -k 1M https://story.josephtran.co/Geth_snapshot.lz4
Terminal window
cp $HOME/.story/story/data/priv_validator_state.json $HOME/.story/priv_validator_state.json.backup && \
rm -rf $HOME/.story/story/data
rm -rf $HOME/.story/geth/iliad/geth/chaindata
Terminal window
sudo mkdir -p $HOME/.story/story/data
lz4 -d -c Story_snapshot.lz4 | pv | sudo tar xv -C $HOME/.story/story/ > /dev/null
cp $HOME/.story/priv_validator_state.json.backup $HOME/.story/story/data/priv_validator_state.json
Terminal window
sudo mkdir -p $HOME/.story/geth/iliad/geth/chaindata
lz4 -d -c Geth_snapshot.lz4 | pv | sudo tar xv -C $HOME/.story/geth/iliad/geth/ > /dev/null

Reload and start story-geth

Terminal window
sudo systemctl daemon-reload && \
sudo systemctl start story-geth && \
sudo systemctl enable story-geth && \
sudo systemctl status story-geth
banner

Reload and start story

Terminal window
sudo systemctl daemon-reload && \
sudo systemctl start story && \
sudo systemctl enable story && \
sudo systemctl status story
banner

Check logs

Terminal window
sudo journalctl -u story-geth -f -o cat
banner

Wait a minute for connect peers

Terminal window
sudo journalctl -u story -f -o cat
banner

Check sync status

Terminal window
curl localhost:26657/status | jq

Check block sync left:

Terminal window
while true; do
    local_height=$(curl -s localhost:26657/status | jq -r '.result.sync_info.latest_block_height');
    network_height=$(curl -s https://rpc-story.josephtran.xyz/status | jq -r '.result.sync_info.latest_block_height');
    blocks_left=$((network_height - local_height));
    echo -e "\033[1;38mYour node height:\033[0m \033[1;34m$local_height\033[0m | \033[1;35mNetwork height:\033[0m \033[1;36m$network_height\033[0m | \033[1;29mBlocks left:\033[0m \033[1;31m$blocks_left\033[0m";
    sleep 5;
done

Create validator

Export validator Public Key & Private key

By default, when you run story init a validator key is created for you. To view your validator key, run the following command:

Terminal window
story validator export

In addition, if you want to export the derived EVM private key of your validator into the default data config directory, please run the following:

Terminal window
story validator export --export-evm-key

Note that to participate in consensus, at least 1 IP must be staked (equivalent to 1000000000000000000 wei)!
Faucet link: https://faucet.story.foundation/

banner
Create validator
Terminal window
story validator create --stake 1000000000000000000 --private-key "your_private_key"
banner

Validator Staking

Terminal window
story validator stake \
   --validator-pubkey "VALIDATOR_PUB_KEY_IN_BASE64" \
   --stake 1000000000000000000 \
   --private-key xxxxxxxxxxxxxx

Replace VALIDATOR_PUB_KEY_IN_BASE64 Amount: 1000000000000000000=1 IP Token

banner

Check your Validator on Explorer

  • Get your validator info:
Terminal window
curl -s localhost:26657/status | jq -r '.result.validator_info'

Result:

  • Paste HEX Validator Address: D6F92FD7D0460AA9E4CF4D299FE479E93395DCF3 to search
https://testnet.story.explorers.guru/
banner

# Delete node

Terminal window
sudo systemctl stop story-geth
sudo systemctl stop story
sudo systemctl disable story-geth
sudo systemctl disable story
sudo rm /etc/systemd/system/story-geth.service
sudo rm /etc/systemd/system/story.service
sudo systemctl daemon-reload
sudo rm -rf $HOME/.story
sudo rm $HOME/go/bin/story-geth
sudo rm $HOME/go/bin/story