v0.14.4 Upgrade Instructions

This page contains upgrade instructions for testnet and mainnet. Always verify which network the instructions apply to.

Upgrade notes

No breaking changes or config requirements for v0.14.4.

1. SSH into the node as root user

2. Upgrade monad package

If you encounter issues with the GPG signature (e.g. signatures were invalid), please renew the keys with the command below.

curl -fsSL https://pkg.category.xyz/keys/public-key.asc \
  | gpg --dearmor --yes -o /etc/apt/keyrings/category-labs.gpg

sudo apt update && sudo apt install --reinstall monad=0.14.4 -y --allow-downgrades --allow-change-held-packages
sudo apt-mark hold monad

The apt-mark hold monad command prevents the monad package from being upgraded automatically by apt-get upgrade. Without it, unattended system upgrades can install a newer version of monad that has not been approved for your network, causing version mismatch issues.

3. Restart the services and verify

sudo systemctl restart monad-bft monad-execution monad-rpc
sudo systemctl status monad-bft monad-execution monad-rpc --no-pager -l

Expected output: All services should show Active: active (running)

4. Verify the correct version is running

monad-rpc --version

Expected output:

monad-rpc {"commit":"06ed5828c45804bc6a0bece00519472152ede07b","tag":"v0.14.4","branch":"","modified":true}