What changes
- Survey visibility: organizations can restrict who sees each survey and its responses. It’s off until you turn it on.
- Encrypted single-use links created before 6.1 stop working and must be created again.
- 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).
Before you upgrade
Patch actions
Check each patch you cross. You can go straight to the latest 6.1 patch.Upgrade
Follow the runbook for your setup: Kubernetes, Docker Compose or one-click. Because the permission schema changes, permission preparation asks you to confirm the change. See schema changes 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.
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. 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.
- Review Helm security contexts and taxonomy timeouts if you use custom images or override taxonomy settings.
- Ending-card URLs need a real host.
buttonLinkandurlon ending cards (v1, v2 and v3 survey create and update) must use a hostname with a dot (intranet.example.com),localhostor an IP address. A host likehttp://intranetnow returns 400. Existing surveys keep loading; the rule applies when they are next saved (#9399) - Hidden fields can’t share a name with a question. Adding one on
POSTorPUT /api/v1/management/surveysreturns 400. Existing surveys keep saving (#9467) - New survey limit per workspace.
SURVEY_WORKSPACE_LIMIT(a number, default10000, archived surveys included) caps the surveys in one workspace. Creating or copying a survey past it returns422 workspace_survey_limit_reachedon v1 and v3. Raise it before upgrading if a workspace is close (#9412)
More 6.1 changes
- Survey visibility (opt-in)
- Complete the survey visibility rollout
- Regenerate encrypted single-use links (if you use them)
- Bundled TEI log level
- Database transaction limits
- 6.1.1: One-click port binding
- Hub worker for Docker
- Cube model files for Docker