Docs
chromia.com

Upgrade Postchain

On this page

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:

Terminal
docker stop postchain
docker rm postchain

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

Pull the subnode image of the new Postchain version:

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

Step 3: Update node vonfiguration (subnodes only)

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

Properties
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:

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

Verification

After completing the upgrade:

  1. Check container status:

    Terminal
    docker ps
  2. Verify node connectivity:

    Terminal
    curl http://127.0.0.1:7751/_debug
  3. Monitor logs for any errors:

    Terminal
    docker logs postchain

Version compatibility