Update Docker Teranode
Last modified: 19-October-2026
Docker updates are managed from the
teranode-quickstart
repository. Quickstart keeps the local Teranode image tag in .env as
TERANODE_VERSION.
Check for an Update
./update.sh --checkThe script compares your local TERANODE_VERSION with the latest Teranode
GitHub release and prints the current tag, target tag, and release URL.
Apply an Update
./update.sh
./start.sh
./status.shupdate.sh only rewrites TERANODE_VERSION in .env. It does not stop Docker,
pull images, or recreate containers. Running ./start.sh after the version
change pulls the selected image and recreates containers whose image tag changed.
For non-interactive use:
./update.sh --yes
./start.shPin or Roll Back
Set a specific Teranode release tag:
./update.sh --to v0.14.2
./start.shUse this for rollback only after checking the release notes for data-format or migration warnings. Teranode applies blockchain store schema changes on startup, and it only applies them forward. To roll back across a release that changes data formats, restore the backup that you took before the upgrade. See How to Back Up and Restore Teranode Data.
Update Quickstart Itself
./update.sh updates the Teranode version pin, not the quickstart repository.
To update quickstart scripts and Compose files:
git pullThen review .env.example for new settings that may be relevant to your local
.env.
Operational Notes
- Data volumes are preserved during normal updates.
- Docker Compose updates are not rolling updates; expect downtime while changed containers restart.
- If a release requires data migration or a full resync, the Teranode release notes should call that out.
- Keep a copy of
.envand any external reverse-proxy configuration before major changes. - Changes to the PostgreSQL
init.sqldo not apply to an existing data directory. If you provisioned the node before Teranode dropped superuser from theteranodePostgreSQL role, apply the one-offALTER ROLEin PostgreSQL Role Privileges.
Related Documentation
- Quickstart update details:
docs/UPDATING.md - Teranode releases: https://github.com/bsv-blockchain/teranode/releases
- Start and Stop Docker Teranode