From 1d0bbbd2c113d33c1b5efd43e5b8db98cd72bd67 Mon Sep 17 00:00:00 2001 From: Chiziaruhoma Ogbonda Date: Mon, 15 Jun 2026 04:23:19 +0100 Subject: [PATCH 1/2] docs: Update legacy auth migration guide to 4.0 --- .../03-migrate-from-legacy-auth.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/docs/11-upgrading/03-migrate-from-legacy-auth.md b/docs/11-upgrading/03-migrate-from-legacy-auth.md index 5aab1492..be02541d 100644 --- a/docs/11-upgrading/03-migrate-from-legacy-auth.md +++ b/docs/11-upgrading/03-migrate-from-legacy-auth.md @@ -1,19 +1,19 @@ --- -description: Move a Serverpod 3.5 project off serverpod_auth_server onto the modular auth stack with email, Google, and Flutter session continuity. +description: Move a Serverpod 4.0 project off serverpod_auth_server onto the modular auth stack with email, Google, and Flutter session continuity. sidebar_label: Migrate from legacy auth --- # Migrate from legacy serverpod_auth -This guide is for apps still running `serverpod_auth_server` on Serverpod 3.4 or earlier 3.5 betas. At the end, existing users sign in through the new modular auth stack with their old passwords and old sessions, and your legacy endpoints keep working until every client has rolled forward. Plan for about an hour, plus migration runtime. +This guide is for apps still running `serverpod_auth_server` on Serverpod 3.4 or earlier 4.0 betas. At the end, existing users sign in through the new modular auth stack with their old passwords and old sessions, and your legacy endpoints keep working until every client has rolled forward. Plan for about an hour, plus migration runtime. ## Before you start -- A Serverpod 3.5.x project. If you are still on 3.4 or earlier, follow [Upgrade to 3.5](./upgrade-to-three-five) first. +- A Serverpod 4.0.x project. If you are still on 3.4 or earlier, follow [Upgrade to 4.0](./upgrade-to-three-five) first. - Dart SDK 3.8.0 or later. - Flutter SDK 3.32.0 or later (only if you are migrating the Flutter app). - Postgres 14 or later, or SQLite3. -- The four auth packages at `3.5.0-beta.9` (or the matching beta on pub.dev): `serverpod_auth_core`, `serverpod_auth_idp`, `serverpod_auth_bridge`, and `serverpod_auth_migration`. These are still beta and may receive breaking changes before 3.5 stable. +- The four auth packages at `4.0.0` (or the matching beta on pub.dev): `serverpod_auth_core`, `serverpod_auth_idp`, `serverpod_auth_bridge`, and `serverpod_auth_migration`. These are still beta and may receive breaking changes before 4.0 stable. - Back up your production database. - Commit your current state on a clean branch. - Restore a copy of production data into a staging environment and rehearse this guide against it before running it for real. @@ -26,32 +26,32 @@ In `_server/pubspec.yaml`: ```yaml dependencies: - serverpod: 3.5.0-beta.9 - serverpod_auth_server: 3.5.0-beta.9 # legacy, keep during migration - serverpod_auth_core_server: 3.5.0-beta.9 - serverpod_auth_idp_server: 3.5.0-beta.9 - serverpod_auth_bridge_server: 3.5.0-beta.9 - serverpod_auth_migration_server: 3.5.0-beta.9 + serverpod: 4.0.0 + serverpod_auth_server: 4.0.0 # legacy, keep during migration + serverpod_auth_core_server: 4.0.0 + serverpod_auth_idp_server: 4.0.0 + serverpod_auth_bridge_server: 4.0.0 + serverpod_auth_migration_server: 4.0.0 ``` In `_client/pubspec.yaml`: ```yaml dependencies: - serverpod_client: 3.5.0-beta.9 - serverpod_auth_core_client: 3.5.0-beta.9 - serverpod_auth_idp_client: 3.5.0-beta.9 - serverpod_auth_bridge_client: 3.5.0-beta.9 + serverpod_client: 4.0.0 + serverpod_auth_core_client: 4.0.0 + serverpod_auth_idp_client: 4.0.0 + serverpod_auth_bridge_client: 4.0.0 ``` In `_flutter/pubspec.yaml`: ```yaml dependencies: - serverpod_flutter: 3.5.0-beta.9 - serverpod_auth_core_flutter: 3.5.0-beta.9 - serverpod_auth_idp_flutter: 3.5.0-beta.9 - serverpod_auth_bridge_flutter: 3.5.0-beta.9 + serverpod_flutter: 4.0.0 + serverpod_auth_core_flutter: 4.0.0 + serverpod_auth_idp_flutter: 4.0.0 + serverpod_auth_bridge_flutter: 4.0.0 ``` `serverpod_auth_bridge_client` and `serverpod_auth_bridge_flutter` are required for the session import covered later under [Update the Flutter app](#update-the-flutter-app). @@ -294,6 +294,6 @@ Reach out on the [community page](../support). ## Related -- [Upgrade to 3.5](./upgrade-to-three-five): do this first. +- [Upgrade to 4.0](./upgrade-to-three-five): do this first. - [Authentication setup](../concepts/authentication/setup): modular configuration reference. - [Database migrations](../concepts/database/migrations): creating and applying schema changes safely. From f2c923b475ff67233aa1bdf29d1af9f795beac02 Mon Sep 17 00:00:00 2001 From: Chiziaruhoma Ogbonda Date: Thu, 18 Jun 2026 09:35:19 +0100 Subject: [PATCH 2/2] docs: Refine migration guide for upgrading from legacy auth to modular auth stack --- docs/11-upgrading/03-migrate-from-legacy-auth.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/11-upgrading/03-migrate-from-legacy-auth.md b/docs/11-upgrading/03-migrate-from-legacy-auth.md index be02541d..7318084b 100644 --- a/docs/11-upgrading/03-migrate-from-legacy-auth.md +++ b/docs/11-upgrading/03-migrate-from-legacy-auth.md @@ -1,19 +1,19 @@ --- -description: Move a Serverpod 4.0 project off serverpod_auth_server onto the modular auth stack with email, Google, and Flutter session continuity. +description: Upgrade from serverpod_auth_server to the new modular auth stack while existing users keep their passwords and sessions and legacy endpoints keep working. sidebar_label: Migrate from legacy auth --- # Migrate from legacy serverpod_auth -This guide is for apps still running `serverpod_auth_server` on Serverpod 3.4 or earlier 4.0 betas. At the end, existing users sign in through the new modular auth stack with their old passwords and old sessions, and your legacy endpoints keep working until every client has rolled forward. Plan for about an hour, plus migration runtime. +This guide is for apps still running `serverpod_auth_server` on Serverpod 3.4 or later. At the end, existing users sign in through the new modular auth stack with their old passwords and old sessions, and your legacy endpoints keep working until every client has rolled forward. Plan for about an hour, plus migration runtime. ## Before you start -- A Serverpod 4.0.x project. If you are still on 3.4 or earlier, follow [Upgrade to 4.0](./upgrade-to-three-five) first. +- A Serverpod 4.0.x project. If you are on an earlier version, follow [Upgrade to 4.0](./upgrade-to-three-five) first. - Dart SDK 3.8.0 or later. - Flutter SDK 3.32.0 or later (only if you are migrating the Flutter app). - Postgres 14 or later, or SQLite3. -- The four auth packages at `4.0.0` (or the matching beta on pub.dev): `serverpod_auth_core`, `serverpod_auth_idp`, `serverpod_auth_bridge`, and `serverpod_auth_migration`. These are still beta and may receive breaking changes before 4.0 stable. +- The four new auth packages at `4.0.0`: `serverpod_auth_core`, `serverpod_auth_idp`, `serverpod_auth_bridge`, and `serverpod_auth_migration`. - Back up your production database. - Commit your current state on a clean branch. - Restore a copy of production data into a staging environment and rehearse this guide against it before running it for real.