Overview
Let’s break down how each of these work.Email address and password
This is the only authentication mechanism where PlanetScale maintains user credentials. Additionally, users can opt to configure two-factor authentication (2FA). This asks for your password and something you have: an authenticator app, a passkey, or a hardware security key. If your passkey confirms it’s you with Face ID, Touch ID, or a PIN, it can also sign you in without a password. Recovery codes are a backup if you lose access to your authenticator app or keys.Single sign-on
Users can authenticate with their chosen corporate identity provider (i.e. Okta) instead of maintaining passwords with PlanetScale. Once SSO is enabled for anorganization, all members are redirected through that identity provider’s authentication flow. Moving forward, they must pass through SSO to access their PlanetScale account.
OAuth via GitHub
Users can authenticate with PlanetScale using their GitHub account.Enabling SSO removes OAuth access for all members of your organization, meaning they will no longer be able
to sign in with their GitHub credentials.
Switch to email and password
You can stop signing in with GitHub and sign in with your email address and a password instead.1
Go to your PlanetScale account settings page.
2
In the Sign in with GitHub section, click “Disconnect GitHub”.
3
Click “Confirm on GitHub” and approve the sign-in on GitHub.
4
Enter and confirm a new password, then click “Disconnect GitHub”.
Accounts that belong to an organization using SSO can’t disconnect GitHub.
Revoke all sessions
If you lose a device, or think someone else might be signed in to your account, you can revoke all of your sessions. This:- Signs you out of PlanetScale in every other browser. The browser you use to revoke your sessions stays signed in.
- Revokes your pscale CLI logins.
- Revokes the OAuth applications you authorized, such as MCP clients.
1
Go to your PlanetScale account settings page.
2
In the Revoke all sessions section, click “Revoke all sessions”.
3
If you’re asked to confirm access to your account, confirm it.
4
Select the checkbox to confirm that your other browsers, CLI logins, and applications will need to sign in again, then click “Revoke all sessions”.
pscale auth login. Reauthorize any applications you still use. The event is recorded in your security log.

