Skip to main content

Upgrading Manager Using Docker Compose

This guide walks you through the process of upgrading your Fluent Manager deployment when hosted via Docker Compose.

When you update Fluent Manager, the backend application will automatically handle migrating the PostgreSQL database schema to the latest version using Liquibase. Because of this, it is crucial to use the deployment script that explicitly matches the version you are upgrading to.

Prerequisites​

  • Current Deployment: You must have an existing Fluent Manager deployment running via Docker Compose.
  • New Script Version: You will need the deployment helper script that matches your target Manager version (e.g., if upgrading to version w.x.y.z, you need the w.x.y.z helper script).
  • Environment File: Access to your existing .env file which contains the FLUENT_MANAGER_KEYSET_HANDLE.
Backup Your Environment File

The .env file generated during your initial deployment contains a unique encryption key (FLUENT_MANAGER_KEYSET_HANDLE). If this key is lost or overwritten, the connection strings stored in your database cannot be decrypted. Always maintain a secure backup of this file before upgrading.

Upgrade Steps​

Step 1: Backup the Database​

Before proceeding with an upgrade, it is highly recommended that you back up your current database. Navigate to your Application Directory and run the backup command using your current (old) deployment script:

kotlin fluent-deploy-docker-compose-w.x.y.z.main.kts db-full-backup

(Replace w.x.y.z with your current script's version number).

Step 2: Download the New Helper Script​

Download the new helper script that matches the version you wish to upgrade to. Save this script in your existing Application Directory alongside your current .env and docker-compose.yml files.

Step 3: Run the Update Command​

Once the new script is in place, run the update command using the new script:

kotlin fluent-deploy-docker-compose-w.x.y.z.main.kts update

(Replace w.x.y.z with the new script's version number).

Step 4: Verify the Upgrade​

Once the deployment finishes, confirm the new version is running by navigating to Settings (gear icon, top right) → Fluent Manager under the About section. The installed version number will be displayed there.