> ## Documentation Index
> Fetch the complete documentation index at: https://formbricks.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 5.1: Upgrade guide

> Apply ordered migrations and review renamed feedback-source data.

**Applies to:** installations crossing 5.1, including upgrades from v4 to a later v5 target.
Both editions and deployment methods. Apply [5.0 prerequisites](https://formbricks.com/docs/self-hosting/upgrade/versions/5.0.md) first when coming from v4.

## Before

| Change | Required action |
| - | - |
| Separate Compose app migration service | [Copy the target’s `formbricks-migrate` service](https://formbricks.com/docs/self-hosting/upgrade/configuration#merge-the-release-configuration), including its environment and dependencies. Use the same app image for migration and runtime. |
| Hub migration ordering | Run application migrations before Hub migrations; make external Secrets available before Argo migration hooks. |
| Connector renamed to FeedbackSource | Back up first; verify existing feedback-source connections after the automatic rename. |
| Prisma 7 runtime | Use the migration runner bundled in the target image. Do not run an older Prisma CLI against the target schema. |
| Cube configuration/healthcheck corrections | Copy the target Cube service and [download both model files](https://formbricks.com/docs/self-hosting/upgrade/configuration.md#download-the-cube-model-files); keep its secret and database overrides. |

The [configuration checklist](https://formbricks.com/docs/self-hosting/upgrade/configuration.md) covers image pins, existing credentials
and storage/proxy preservation. New optional features are not prerequisites for this upgrade.

## During

Use the [4.x/5.x maintenance procedure](https://formbricks.com/docs/self-hosting/upgrade/legacy.md). Keep traffic and writers stopped
through app and Hub migrations. Require both to exit successfully before starting the target app.
A Compose `up -d` or an Argo sync beginning is not evidence that migrations finished.

## After

Verify existing feedback sources, dashboards, SSO, uploads and the
[shared acceptance checks](https://formbricks.com/docs/self-hosting/upgrade/rehearse.md#acceptance-at-every-stop).
Check the migration containers/Jobs themselves for completion and inspect any failure before continuing.

## Recovery

The table and enum rename is not reversed by an older image. Restore matching configuration, images and
coordinated data when rolling back across this boundary. See [recovery](https://formbricks.com/docs/self-hosting/operate/backup-restore.md).

Source: [5.0.2 → 5.1.0](https://github.com/formbricks/formbricks/compare/5.0.2...5.1.0).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.