Download and Restore Container Images of QMetry Products

This topic describes how to download QMetry container images with Podman on a machine that has internet access, save them as `.tar` files, and use the files for an offline installation or upgrade on a target server.

Prerequisites

Before you begin, make sure that you have the following:

  • A machine with internet access and Podman installed.

  • Container registry credentials for Docker Hub. If you do not have credentials, contact QMetry Support.

  • Write access to the /opt directory on the machine, and enough free disk space for all the images that you need to download.

  • The list of QMetry components that you plan to install or upgrade. Download only the images for those components.

Log In to the Container Registry

You need to log in only once on the machine before you download any image.

To log in to the container registry, do the following:

  • Run the following command, and enter your container registry credentials.

    podman login docker.io
    image-20220215-070122__1_.png

Download the QMetry Database Image

To download and save the QMetry Database container image, do the following:

  1. Download the image and verify that it is listed:

    podman pull 
docker.io/qmetry/qmetry:appdb848
podman images

  2. Save the image and verify that the file exists in the `/opt` directory.

    podman save -o /opt/qmetrydb.tar 
docker.io/qmetry/qmetry:appdb848
ls /opt
    image-20241125-150233.png

  3. Transfer the qmetrydb.tar file to the target server.

Download QMetry Application Image

To download and save the QMetry Application container image, do the following:

  1. Download the image and verify that it is listed.

    podman pull docker.io/qmetry/qmetry:latest
podman images

  2. Save the image and verify that the file exists in the `/opt` directory.

    podman save -o /opt/qmetryapp.tar docker.io/qmetry/qmetry:latest
ls /opt

  3. Transfer the qmetryapp.tar file to the target server.

Download the QMetry Report Images

To download and save the QMetry Report container images, do the following:

  1. Download the Report Database image and verify that it is listed:

    podman pull 
docker.io/qmetry/qmetry:reportdb848
podman images

  2. Save the Report Database image and verify that the file exists in the /opt directory:

    podman save -o /opt/qmetryreportdb.tar 
docker.io/qmetry/qmetry:reportdb848
ls /opt

  3. Download the Change Data Capture (CDC) image.

    podman pull docker.io/qmetry/qmetry:cdc_latest

  4. Save the CDC image:

    podman save -o /opt/qmetrycdc.tar docker.io/qmetry/qmetry:cdc_latest

  5. Download the Sync image:

    podman pull docker.io/qmetry/qmetry:sync_latest

  6. Save the Sync image:

    podman save -o /opt/qmetrysync.tar docker.io/qmetry/qmetry:sync_latest

  7. Verify that the images are listed and that the files exist in the /opt directory:

    podman images
ls /opt

  8. Transfer the qmetryreportdb.tar, qmetrycdc.tar, and qmetrysync.tar files to the target server.

Download the QMetry Redis Image

To download and save the QMetry Redis container image, do the following:

  1. Download the image and verify that it is listed.

    podman pull 
docker.io/qmetry/qmetry:redis840
podman images

  2. Save the image and verify that the file exists in the /opt directory.

    podman save -o /opt/redis.tar 
docker.io/qmetry/qmetry:redis840
ls /opt

  3. Transfer the redis.tar file to the target server.

Download the QMetry ActiveMQ Image

To download and save the QMetry ActiveMQ container image, do the following:

  1. Download the image and verify that it is listed.

    podman pull docker.io/qmetry/qmetry:activemq_latest
podman images

  2. Save the image and verify that the file exists in the /opt directory.

    podman save -o /opt/qmetryactivemq.tar docker.io/qmetry/qmetry:activemq_latest
ls /opt

  3. Transfer the qmetryactivemq.tar file to the target server.

Download the QMetry Automation API Image

To download and save the QMetry Automation API container image, do the following:

  1. Download the image and verify that it is listed:

    podman pull docker.io/qmetry/qmetry:automation_latest
podman images

  2. Save the image and verify that the file exists in the /opt directory:

    podman save -o /opt/qmetryautomation.tar docker.io/qmetry/qmetry:automation_latest
ls /opt

  3. Transfer the qmetryautomation.tar file to the target server.Transfer the .tar file to the target server.

Download the QMetry BDD Image

To download and save the QMetry BDD container image, do the following:

  1. Download the image and verify that it is listed:

    podman pull docker.io/qmetry/qmetry:bdd_latest
podman images

  2. Save the image and verify that the file exists in the /opt directory:

    podman save -o /opt/qmetrybdd.tar docker.io/qmetry/qmetry:bdd_latest
ls /opt

  3. Transfer the qmetrybdd.tar file to the target server.

Transfer the Container Images and Run the Installer

Transfer the required `.tar` files to the respective servers before you start the installation or upgrade. The installer loads the images from the `.tar` files, so you do not need to load them manually.

When you run `install.sh` or `upgrade.sh`, the installer asks the following question.

Options

Allowed Values

Default Value

Recommended Value

Do you want to make an online installation (Y/N)?

Y, y, N, n

Y

N

To install or upgrade offline by using the local image files, do the following:

  1. Enter N.

    The installer asks for the location of the `.tar` file for the component that you install or upgrade. For example, for the QMetry database component, the installer displays the following text.

    Please enter directory path of qmetrydb.tar file for docker image:

  2. Enter the path of the directory that contains the file, not the path of the file itself. For example, if the file is at /opt/qmetrydb.tar, enter /opt.

The installer locates the `qmetrydb.tar` file in the directory that you specify and continues. For each additional component that you install or upgrade, enter the directory path of the corresponding `.tar` file.

Contact QMetry Support

If you do not have container registry credentials, or if you need help with the installation, contact QMetry Support.

In this section:
© 2026
Publication date: