This guide allows you to manually upgrade the story and story-geth binaries from a specific GitHub tag without using the auto-upgrade script.

📦 Update story Binary

Set the target version tag

bash
STORY_TAG="v1.3.0"

Clone and checkout the repository

bash
rm -rf $HOME/tmp-manual-upgrade/story
git clone https://github.com/piplabs/story $HOME/tmp-manual-upgrade/story
cd $HOME/tmp-manual-upgrade/story
git checkout "$STORY_TAG"

Build the binary

bash
go build -o $HOME/tmp-manual-upgrade/story_binary ./client

Replace binary and restart service

bash
sudo systemctl stop story-geth && sudo systemctl stop story
sudo mv $HOME/tmp-manual-upgrade/story_binary $HOME/go/bin/story
sudo systemctl start story-geth && sudo systemctl start story

Info

Make sure Go is installed and $HOME/go/bin is in your PATH.

Update story-geth Binary

Set the target version tag

bash
GETH_TAG="v1.1.0"

Clone and checkout the repository

bash
rm -rf $HOME/tmp-manual-upgrade/story-geth
git clone https://github.com/piplabs/story-geth $HOME/tmp-manual-upgrade/story-geth
cd $HOME/tmp-manual-upgrade/story-geth
git checkout "$GETH_TAG"

Build the binary

bash
go build -o $HOME/tmp-manual-upgrade/geth_binary ./cmd/geth

Replace binary and restart service

bash
sudo systemctl stop story-geth && sudo systemctl stop story
sudo mv $HOME/tmp-manual-upgrade/geth_binary $HOME/go/bin/story-geth
sudo systemctl start story-geth && sudo systemctl start story

Info

You can upgrade both story and story-geth in sequence using the same method.