# Upgrade Postchain · Chromia Docs (concept)

> This guide provides step-by-step instructions for upgrading Postchain to a new version.

Source: https://docs.chromia.com/ecosystem/providers/nodes/upgrade-postchain/

# Upgrade Postchain

On this page

* [Prerequisites](#prerequisites)
* [Upgrade process](#upgrade-process)
* [Step 1: Stop and remove current container](#step-1-stop-and-remove-current-container)
* [Step 2: Pull a new subnode image (subnodes only)](#step-2-pull-a-new-subnode-image-subnodes-only)
* [Step 3: Update node vonfiguration (subnodes only)](#step-3-update-node-vonfiguration-subnodes-only)
* [Step 4: Start Postchain with the new version](#step-4-start-postchain-with-the-new-version)
* [Verification](#verification)
* [Version compatibility](#version-compatibility)

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)

note

Skip this step if you are **not** running with subnodes.

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)

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:

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
```

tip

Replace `[your-existing-docker-parameters]` with the same parameters you used when initially starting your Postchain
container. Refer to the [Start a node](https://docs.chromia.com/ecosystem/providers/nodes/start-a-node/) guide if you need to review the complete docker run command
structure.

## 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

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`.

[View this page on docs.chromia.com](https://docs.chromia.com/ecosystem/providers/nodes/upgrade-postchain/)Content mirrored from the live docs
