Upgrade Flowise in Coolify

Complete step-by-step instructions for upgrading Flowise in Coolify

Quick Preparation (Do Once)

Important: Always backup your data before upgrading to prevent any potential data loss.

In Flowise, export your important flows/workspaces via Settings → Export to create a JSON backup
In Coolify navigate to Projects → flowise-ai → Persistent Storages and note the mounted path (usually the app's ~/.flowise folder) - this is where your database and files are stored for rollback purposes

Choose Version Tracking Method

Best Practice: Pin an explicit image tag instead of using latest for better version control and predictability.

Example tags you can use:

flowiseai/flowise:3.0.5

Replace with the specific version you want to upgrade to.

Update the Image in Coolify

Option A: Pin/Switch to a Specific Version

Navigate to Coolify → Projects → flowise-ai and click Edit Compose File
Find the line that looks like:

image: flowiseai/flowise:latest

Change it to:

image: flowiseai/flowise:3.x.y

Click Save, then click Restart (or Redeploy/Rebuild if available)
Coolify will pull the new image and start the updated version

Option B: Stay on Latest but Force an Update

Keep the line as image: flowiseai/flowise:latest
From the service page, open Settings (gear icon) and use Rebuild / Force pull image
Then click Restart

A plain restart may reuse the cached image - you need a pull/rebuild to fetch the new latest version.

Verify After Upgrade

Open Flowise and log in to your instance
Check the version in the About/info menu or footer
If version info isn't visible, you can hit the API endpoint /api/v1/system and look at the version field
Perform a smoke-test by running one of your existing flows

Rollback Process (If Needed)

If you encounter any issues with the new version, you can quickly roll back:

Edit the Compose file again and set the previous tag (e.g., flowiseai/flowise:3.0.4)
Click Save → Redeploy/Rebuild
Your data will remain intact because it's stored on the persistent volume

Notes for Version 3+ Upgrades

Keep your FLOWISE_USERNAME and FLOWISE_PASSWORD environment variables unchanged during upgrades. These are only used for initial organization setup and basic authentication checks.

You'll continue logging in with the admin email you previously configured
If you ever change those environment variables, you'll be prompted to re-confirm them on the setup screen
Version 3+ maintains backward compatibility with your existing flows and configurations