How do I update metasfresh using Docker? (Install Release Candidate)

Requirements

1. You will need a running Docker-based metasfresh system.
2. Make sure you are using PostgreSQL database version 15 on your metasfresh instance (since release version 5.175). Follow this guide to upgrade your database accordingly.

Steps for Version Update

1. Stop all Docker containers.

    docker-compose stop
   

2. Create a backup of the entire current Docker workspace.

    tar cvzf ../backup.tar.gz ./<mydocker fir>/* --BACKUP
    docker-compose rm
   

3. In the metasfresh-docker directory, change the Dockerfile versions of App, WebAPI, WebUI and DB (in the subdirectories) to the next version number, e.g., 5.175.
4. Rebuild the images.

    docker-compose build --no-cache
   

5. Start the Docker containers.

    docker-compose up -d
   

Alternative Steps

If you want to pull the new Docker files from GitHub directly, please proceed as follows:

1. Stop all Docker containers.
2. Create a backup of the current Docker workspace.
3. Delete the host’s images of app, webui and webapi.
4. Get the new Docker files and configurations from GitHub.
5. Adjust the hostname in the docker-compose.yml file.
6. Rebuild the images.
7. Start the Docker containers.

Commands

cd metasfresh-docker
docker-compose down
tar cvzf ../backup.tar.gz ./*
git pull
vi ./docker-compose.yml
docker-compose build
docker-compose up -d

If you’ve changed the docker-compose.yml file (e.g., different ports) and want to save it first, use:

cd metasfresh-docker
docker-compose down
tar cvzf ../backup.tar.gz ./*
cp -a ./docker-compose.yml ../
git pull
mv ../docker-compose.yml ./
docker-compose build
docker-compose up -d