Skip to main content

Installation

Chain IDLatest Version TagCustom Port
story-1v1.4.2126
Validator Name Configuration

To configure your validator name, replace the placeholder owlstake with your desired validator name.

MONIKER="owlstake"

Dependency Installation Process​

System Update and Build Tool Installation​

sudo apt -q update
sudo apt -qy install curl git jq lz4 build-essential
sudo apt -qy upgrade

Install Go​

sudo rm -rf /usr/local/go
curl -Ls https://go.dev/dl/go1.22.5.linux-amd64.tar.gz | sudo tar -xzf - -C /usr/local
eval $(echo 'export PATH=$PATH:/usr/local/go/bin' | sudo tee /etc/profile.d/golang.sh)
eval $(echo 'export PATH=$PATH:$HOME/go/bin' | tee -a $HOME/.profile)

Download and build binaries​

# Clone project repository
cd $HOME
rm -rf story
git clone https://github.com/piplabs/story
cd story
git checkout v1.4.2

# Build binaries
make build

# Prepare binaries for Cosmovisor (Optional)
mkdir -p $HOME/.story/story/cosmovisor/genesis/bin
mv build/story $HOME/.story/story/cosmovisor/genesis/bin/
rm -rf build

# Create application symlinks (Optional)
sudo ln -s $HOME/.story/story/cosmovisor/genesis $HOME/.story/story/cosmovisor/current -f
sudo ln -s $HOME/.story/story/cosmovisor/current/bin/story /usr/local/bin/story -f

Install Cosmovisor and create a service (Option 1)​

# Download and install Cosmovisor 
go install cosmossdk.io/tools/cosmovisor/cmd/[email protected]

# Create service
sudo tee /etc/systemd/system/story.service > /dev/null << EOF
[Unit]
Description=story node service
After=network-online.target

[Service]
User=$USER
ExecStart=$(which cosmovisor) run start
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
Environment="DAEMON_HOME=$HOME/.story/story"
Environment="DAEMON_NAME=story"
Environment="UNSAFE_SKIP_BACKUP=true"
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games:/snap/bin:$HOME/.story/story/cosmovisor/current/bin"

[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable story

Create a standard service (Option 2)​

# Create service
sudo tee /etc/systemd/system/story.service > /dev/null << EOF
[Unit]
Description=story node service
After=network-online.target

[Service]
Type=simple
User=$USER
ExecStart=$(which story) start
Restart=on-failure
RestartSec=10
LimitNOFILE=65535
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable story

Initialize the node​

# Set node configuration
story config chain-id story-1
story config keyring-backend file
### (Optional)
story config node tcp://localhost:12657

# Initialize the node
story init --moniker $MONIKER --network story

# Download genesis and addrbook
curl -Ls https://snapshots.owlstake.com/story-1/genesis.json > $HOME/.story/story/config/genesis.json
curl -Ls https://snapshots.owlstake.com/story-1/addrbook.json > $HOME/.story/story/config/addrbook.json

# Add seeds
sed -i -e "s|^seeds *=.*|seeds = \"[email protected]:45656\"|" $HOME/.story/story/config/config.toml
# Set minimum gas price
sed -i -e "s|^minimum-gas-prices *=.*|minimum-gas-prices = \"0.002uip\"|" $HOME/.story/story/config/app.toml

# Set pruning
sed -i \
  -e 's|^pruning *=.*|pruning = "custom"|' \
  -e 's|^pruning-keep-recent *=.*|pruning-keep-recent = "100"|' \
  -e 's|^pruning-keep-every *=.*|pruning-keep-every = "0"|' \
  -e 's|^pruning-interval *=.*|pruning-interval = "19"|' \
  $HOME/.story/story/config/app.toml

# Set custom ports (Optional)
sed -i -e "s%^proxy_app = \"tcp://127.0.0.1:26658\"%proxy_app = \"tcp://127.0.0.1:12658\"%; s%^laddr = \"tcp://127.0.0.1:26657\"%laddr = \"tcp://127.0.0.1:12657\"%; s%^pprof_laddr = \"localhost:6060\"%pprof_laddr = \"localhost:12660\"%; s%^laddr = \"tcp://0.0.0.0:26656\"%laddr = \"tcp://0.0.0.0:12656\"%; s%^prometheus_listen_addr = \":26660\"%prometheus_listen_addr = \":12666\"%" $HOME/.story/story/config/config.toml
sed -i -e "s%^address = \"tcp://0.0.0.0:1317\"%address = \"tcp://0.0.0.0:12617\"%; s%^address = \":8080\"%address = \":12680\"%; s%^address = \"0.0.0.0:9090\"%address = \"0.0.0.0:12690\"%; s%^address = \"0.0.0.0:9091\"%address = \"0.0.0.0:12691\"%; s%:8545%:12645%; s%:8546%:12646%; s%:6065%:12665%" $HOME/.story/story/config/app.toml

Download latest chain snapshot​

curl -L https://snapshots.owlstake.com/story-1/snapshot_latest.tar.lz4 | tar -I lz4 -xf - -C $HOME/.story/story
[[ -f $HOME/.story/story/data/upgrade-info.json ]] && cp $HOME/.story/story/data/upgrade-info.json $HOME/.story/story/cosmovisor/genesis/upgrade-info.json

Start service and check the logs​

sudo systemctl start story && sudo journalctl -u story -f --no-hostname -o cat

####################################

Download binaries Geth​

# download binaries
cd $HOME
rm -rf story-geth
wget -O story-geth https://github.com/piplabs/story-geth/releases/download/v1.1.2/geth-linux-amd64
chmod +x $HOME/story-geth
mv $HOME/story-geth $HOME/go/bin/
[ ! -d "$HOME/.story/geth" ] && mkdir -p "$HOME/.story/geth"

Create geth servie file​

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

[Service]
User=$USER
ExecStart=$(which story-geth) --story --syncmode full \
--http --http.api eth,net,web3,engine --http.vhosts '*' \
--http.addr 0.0.0.0 \
--ws --ws.api eth,web3,net,txpool \
--ws.addr 0.0.0.0
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

Download latest chain snapshot​

rm -rf $HOME/.story/geth/story/geth/chaindata
mkdir -p $HOME/.story/geth/story/geth
curl https://snapshots.owlstake.com/story-1/geth_story_snapshot_latest.tar.lz4 | lz4 -dc - | tar -xf - -C $HOME/.story/geth/story/geth

Start service and check the logs​

sudo systemctl start story-geth && sudo journalctl -u story-geth -f --no-hostname -o cat