Upgrade Postchain

This guide provides step-by-step instructions for upgrading Postchain to a new version. The process differs depending on whether you're running with subnodes or not.

Prerequisites

Before starting the upgrade process, ensure you have:

• Access to your server with appropriate permissions
• Docker installed and running
• Current Postchain container running
• Backup of your configuration files (recommended)

Upgrade process

Step 1: Stop and remove current container

Stop and remove the existing Postchain container:

docker stop postchain
docker rm postchain

Step 2: Pull a new subnode image (subnodes only)

note

Skip this step if you are not running with subnodes.

Pull the subnode image of the new Postchain version:

docker pull registry.gitlab.com/chromaway/postchain-chromia/chromaway/chromia-subnode:3.30.7

Step 3: Update node vonfiguration (subnodes only)

note

Skip this step if you are not running with subnodes.

Update the container.docker-image property in your node properties file to reflect the new subnode image:

container.docker-image=registry.gitlab.com/chromaway/postchain-chromia/chromaway/chromia-subnode:3.30.7

Step 4: Start Postchain with the new version

Start the Postchain container (chromia-server) with the new version:

docker run [your-existing-docker-parameters] chromia-server:3.30.7

tip

Replace [your-existing-docker-parameters] with the same parameters you used when initially starting your Postchain container. Refer to the Start a node guide if you need to review the complete docker run command structure.

Verification

After completing the upgrade:

1. Check container status:

   docker ps

2. Verify node connectivity:

   curl http://127.0.0.1:7751/_debug

3. Monitor logs for any errors:

   docker logs postchain

Version compatibility

warning

Ensure that the Postchain server version matches your node type version. For example, if you're upgrading to Postchain server 3.30.7, all related subnode images should also be version 3.30.7.