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
Expected output:
monad-rpc {"commit":"06ed5828c45804bc6a0bece00519472152ede07b","tag":"v0.14.4","branch":"","modified":true}