How can I update my SuperTokens core instance?

Last updated: October 16, 2025

We publish regular updates and features for our core service. You can check our changelog for an up to date list. To make sure that you're using the latest version you have to manually update your instance. The instructions differ based on if you are using the managed or the self-hosted version.

Managed service

  1. Access the SuperTokens SaaS Dashboard an select the core instance that you want to upgrade.

  2. Look for the core version label and click on the Upgrade button.

Self-hosted

If you are using the docker image you can just change the version tag and update your deployment. For the binary version you will have to download and install the newer version.

Best Practices for Core Upgrades

Upgrade Development First

Always upgrade your development environments before production. This allows you to:

  • Test compatibility with your current SDK versions

  • Identify any issues before they affect production users

  • Validate that your application works correctly with the new core version

SDK Compatibility

Before requesting a core upgrade, ensure your SDK versions are compatible with the target core version. Check the SDK compatibility table in the SuperTokens documentation. If needed, upgrade your frontend and backend SDKs first.

Troubleshooting

If you encounter issues after a core upgrade:

  • Check that your SDK versions are compatible with the new core version

  • Contact support immediately - they can deploy fixes for migration-related issues

  • Provide specific error messages to help the team diagnose problems quickly

The SuperTokens team will work with you to resolve any compatibility issues that arise during the upgrade process.