Upgrading-Stacks-Blockchain.md

Upgrading Stacks Blockchain

Files:

• https://github.com/stacks-network/stacks-blockchain/releases/tag/2.05.0.3.0
• https://github.com/stacks-network/stacks-blockchain/archive/refs/tags/2.05.0.3.0.tar.gz
• https://github.com/stacks-network/stacks-blockchain

Docker:

• https://hub.docker.com/r/blockstack/stacks-blockchain/tags
• https://hub.docker.com/layers/blockstack/stacks-blockchain/2.05.0.3.0/images/sha256-c1ee42db175ef9a582c23d164e37dbfbc9829568eaa1e6fb933d09840ff2fc5f?context=explore

Ensure any existing stacks-node processes are stopped before proceeding

• If running via a binary:

$ ps auxx | grep stacks-node
user      1598 41.2  6.7 4875916 515664 ?      Sl   20:48   5:21 /usr/local/bin/stacks-node start --config=/stacks-blockchain/Config.toml
$ kill 1598

• If running via Docker:

$ docker stop stacks-blockchain

• If running via stacks-blockchain-docker repository:

$ ./manage.sh -n mainnet -a stop

Running stacks-blockchain binary built from source:

1. Download stacks-blockchain source archive: https://github.com/stacks-network/stacks-blockchain

2. Extract and build the stacks-node binary from the source code

    $ git clone https://github.com/stacks-network/stacks-blockchain
    $ cd ./stacks-blockchain/testnet/stacks-node
    $ cargo build --features monitoring_prom,slog_json --release --bin stacks-node
    $ sudo cp -a ../../target/release/stacks-node /usr/local/bin/stacks-node

3. Start the stacks-node binary normally

Running stacks-blockchain pre-built binary:

1. Download stacks-blockchain binary archive for your system's architecture: https://github.com/stacks-network/stacks-blockchain/releases/tag/2.05.0.3.0

2. Extract and install the stacks-node binary from the archive

$ unzip linux-x64.zip
$ sudo cp -a ./linux-x64/stacks-node /usr/local/bin/stacks-node

3. Start the stacks-node binary normally

Running stacks-blockchain using Docker:

1. Download stacks-blockchain Docker image: docker pull blockstack/stacks-blockchain:2.05.0.3.0

2. Update the Docker image being launched

• If running the stacks-blockchain container natively with Docker, simply update the image used to: blockstack/stacks-blockchain:2.05.0.3.0
  • Start the container using this image as you normally would start the stacks-blockchain container.
• If using the stacks-blockchain-docker repository
  • edit .env so the line STACKS_BLOCKCHAIN_VERSION to use `2.05.0.3.0

3. Start the service normally, i.e. ./manage.sh -n mainnet -a start (use the same startup command you would normally run)