> ## 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.

# 6.1: Upgrade guide

> What changes in 6.1 and what you need to do when you upgrade.

**Upgrade from:** the latest 6.0 patch. Skipping 6.0 is not supported; see [Upgrade paths](https://formbricks.com/docs/self-hosting/upgrade/paths.md).
**Downtime:** a maintenance window. **Applies to:** all editions and setups.

## What changes

* Survey visibility: organizations can restrict who sees each survey and its responses. It's off until you [turn it on](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-visibility.md).
* Encrypted single-use links created before 6.1 stop working and must be [created again](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links.md).
* The permission schema changes, so permission preparation is needed.
* New database indexes are built, and Embedded Data and survey ownership are backfilled during the migration.
* Some API requests are validated more strictly (see [integration changes](#integration-changes-requiring-action)).

## Before you upgrade

| Who | What to do |
| - | - |
| Everyone | Plan a maintenance window. The migration builds indexes and backfills data, so allow extra time and free disk space on large databases. |
| API integrations | Check the [integration changes](#integration-changes-requiring-action) below. |
| Single-use link users | Plan to [create new encrypted single-use links](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links.md) after the upgrade. |
| Docker Compose and one-click | Add the Hub worker if it's missing, and use the 6.1 Cube model files. See [runtime changes](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-runtime.md). |
| Kubernetes with chart-managed Envoy | Use your own Redis or Valkey for Envoy; the bundled Envoy Redis images are no longer available. See [Envoy Redis images](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-runtime.md#envoy-redis-images). |
| Kubernetes with custom images or taxonomy settings | Check the [security contexts and taxonomy timeouts](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-runtime.md#helm-security-contexts-and-taxonomy-timeouts). |

### Patch actions

Check each patch you cross. You can go straight to the latest 6.1 patch.

| Patch | Upgrade impact |
| - | - |
| 6.1.1 | Action required for some setups: [6.1.1 security updates](https://formbricks.com/docs/self-hosting/upgrade/versions/2026-10-security-patches.md) (Redis CA, Hub, MCP batches, one-click port binding). |
| 6.1.2 | Action required for some setups: [6.1.2 security updates](https://formbricks.com/docs/self-hosting/upgrade/versions/2026-10-27-patches.md) (email limits, signed-link gates, taxonomy image). |
| 6.1.3 | None. See [6.1.3](https://formbricks.com/docs/platform/changelog.md#release-6-1-3). |
| 6.1.4 | None. Adds the optional `SMTP_REQUIRE_TLS` setting. See [6.1.4](https://formbricks.com/docs/platform/changelog.md#release-6-1-4). |

## Upgrade

Follow the runbook for your setup: [Kubernetes](https://formbricks.com/docs/self-hosting/upgrade/kubernetes.md),
[Docker Compose](https://formbricks.com/docs/self-hosting/upgrade/docker.md) or [one-click](https://formbricks.com/docs/self-hosting/upgrade/one-click.md).
Because the permission schema changes, permission preparation asks you to confirm the change. See
[schema changes](https://formbricks.com/docs/self-hosting/upgrade/prepare.md) in permission preparation.

## Check it worked

* Users can sign in, including existing SSO users, and see the surveys they should.
* You can submit a survey response, and API keys work for what they're allowed to do.
* Webhooks and workflows run, and dashboard charts load.
* Old and new file uploads open.
* Then create new encrypted single-use links, and turn on survey visibility if you want it.

Also do the [checks after the upgrade](https://formbricks.com/docs/self-hosting/advanced/upgrade.md#after-the-upgrade).

## If something goes wrong

Keep the maintenance window open. If you can't fix the problem, restore the app database, Hub data, SpiceDB and
your configuration from the backup; see [backup and restore](https://formbricks.com/docs/self-hosting/operate/backup-restore.md). Don't go back to
an older version just to make old single-use links work again: that reopens the security issue 6.1 fixes.

## Integration changes requiring action

6.1 is a minor release, but these changes can affect existing integrations.

* Regenerate [encrypted single-use links](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links.md).
* Review [Helm security contexts and taxonomy timeouts](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-runtime.md#helm-security-contexts-and-taxonomy-timeouts)
  if you use custom images or override taxonomy settings.

**API**

* **Ending-card URLs need a real host.** `buttonLink` and `url` on ending cards (v1, v2 and v3 survey create and update) must use a hostname with a dot (`intranet.example.com`), `localhost` or an IP address. A host like `http://intranet` now returns 400. Existing surveys keep loading; the rule applies when they are next saved ([#9399](https://github.com/formbricks/formbricks/pull/9399))
* **Hidden fields can't share a name with a question.** Adding one on `POST` or `PUT /api/v1/management/surveys` returns 400. Existing surveys keep saving ([#9467](https://github.com/formbricks/formbricks/pull/9467))
* **New survey limit per workspace.** `SURVEY_WORKSPACE_LIMIT` (a number, default `10000`, archived surveys included) caps the surveys in one workspace. Creating or copying a survey past it returns `422 workspace_survey_limit_reached` on v1 and v3. Raise it before upgrading if a workspace is close ([#9412](https://github.com/formbricks/formbricks/pull/9412))

## More 6.1 changes

* [Survey visibility (opt-in)](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-visibility.md#survey-visibility-opt-in)
* [Complete the survey visibility rollout](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-visibility.md#complete-the-visibility-rollout)
* [Regenerate encrypted single-use links (if you use them)](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-single-use-links.md#encrypted-single-use-survey-links-must-be-regenerated-action-required-if-you-use-them)
* [Bundled TEI log level](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-runtime.md#bundled-tei-log-level)
* [Database transaction limits](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-runtime.md#database-transaction-limits)
* [6.1.1: One-click port binding](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-runtime.md#one-click-port-3000-is-published-on-the-host-only)
* [Hub worker for Docker](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-runtime.md#hub-worker-for-docker)
* [Cube model files for Docker](https://formbricks.com/docs/self-hosting/upgrade/versions/6.1-runtime.md#cube-model-files-for-docker)

See the [release notes](https://formbricks.com/docs/platform/changelog.md) for each 6.1 patch.


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