Skip to main content
Applies to: installations entering v4, Docker/one-click and Kubernetes, both editions. If you already run v4, use the 4.x changes and upgrade-path table. Older release notes remain available for recovery; this does not extend their maintenance window.

Before

S3 storage is required when using files, including uploads, image choices, logos and survey backgrounds. Existing S3/MinIO installations can keep their bucket and credentials. RustFS is not a v4 migration requirement. Set these on the Formbricks app service, using credentials and a bucket created with your storage provider. For Compose, edit formbricks.environment; for Kubernetes, use your application Secret/environment bindings. These are placeholders, not credentials to generate with OpenSSL:
Omit the custom endpoint/path-style override for standard AWS S3. Check browser access, TLS and CORS. Keep the local upload backup until old files have been verified in the new storage.

Legacy local-upload migration

The v4 migration script contains the original Redis/MinIO setup and local-file transfer procedure. Review it against your existing volumes, proxy and chosen storage, then rehearse on a copy. It changes Compose and can restart services; back up files and configuration and pin the app to your chosen v4 image first. Do not download today’s updater or replace an existing MinIO setup just to enter v4.

During

Follow the 4.x/5.x maintenance procedure. Keep traffic closed while the app’s startup migrations complete. Stop on migration or file-transfer errors; do not discard the old upload volume.

After

  • Open existing surveys and compare stored responses with the baseline.
  • Open old images/files and upload/download a new file through the public hostname.
  • Confirm Redis connectivity, sign-in and the shared acceptance checks.

Recovery

Restore the pre-upgrade database, files, configuration and matching images together. Retain the old upload volume until acceptance. See backup and restore. Source: 4.0.0 release and its tagged deployment/migration files.