important
This is a contributors guide and NOT a user guide. Please visit these docs if you are using or evaluating SuperTokens.
Upgrading user's core version
- Tables to update:
- apps (update core_version, plugin_interface_versio and plugin_version)
- aws_containers (update image_version)
- System Manager:
- Find instance id
- Find StartUpdateSuperTokens command for relevant app
- Copy to new
- Change imageVersion parameter
- Make sure the Document version is relevant to the new core version
- Run command and check the container is updated and running
Core DB Migration
3.3 to 3.4#
- No change
3.4 to 3.5#
- Change
user_idinemailverification_verified_emailstoVARCHAR(128) - Change
user_idinemailverification_tokenstoVARCHAR(128) - Add new table (use the db_user associated with user's core or remember to change the owner of the new tables to db_user):This means that the content from other
CREATE TABLE IF NOT EXISTS all_auth_recipe_users(
user_id CHAR(36) NOT NULL,
recipe_id VARCHAR(128) NOT NULL,
time_joined BIGINT NOT NULL,
PRIMARY KEY (user_id)
);
CREATE INDEX all_auth_recipe_users_pagination_index ON all_auth_recipe_users (time_joined DESC, user_id DESC);emailpassword_usersand fromthirdparty_usersneed to be copied into this table - Deleted index
emailpassword_user_pagination_indexandthirdparty_users_pagination_index
3.5 to 3.6#
- No manual change required
3.6 to 3.7#
- No manual change required
3.7 to 3.8#
- No manual change required
- Adds new tables for passwordless (is added automatically):
passwordless_usersthat stores the users of the passwordless recipepasswordless_devicesthat stores devices/information about passwordless login attemptspasswordless_codesthat stores the codes each device can consume to finish the login process
3.8 to 3.9#
- No manual change required
3.9 to 3.10#
- No manual change required
3.10 to 3.11#
- No manual change required
3.11 to 3.12#
- No manual change required
3.12 to 3.13#
- No manual change required
3.13 to 3.14#
- No manual change required
3.14 to 3.15#
- No manual change required
3.15 to 3.16#
- No manual change required
3.16 to 4.0#
- Run:
ALTER TABLE thirdparty_users ALTER COLUMN third_party_user_id TYPE VARCHAR(256); ALTER TABLE emailpassword_users ALTER COLUMN password_hash TYPE VARCHAR(256);
4.0 to 4.1#
- No manual change required
4.1 to 4.2#
- No manual change required
4.2 to 4.3#
- No manual change required
4.3 to 4.4#
- No manual change required
4.4 to 4.5#
- No manual change required
4.5 to 4.6#
- No manual change required