Errors

NUXT_AUTH_STORAGE_CLIENT_ONLY: Secondary storage in client-only mode

Remove server secondary-storage configuration from an app that only connects to an external auth server.

Example error

[NUXT_AUTH_STORAGE_CLIENT_ONLY] hubSecondaryStorage is not available in clientOnly mode.

Why this happens

The app enables clientOnly and requests custom hubSecondaryStorage. This app does not run the auth server, so it cannot configure that server's session storage.

How to fix it

Either disable clientOnly or remove auth.hubSecondaryStorage.

Keep the frontend in client-only mode and remove its secondary-storage option:

nuxt.config.ts

export default defineNuxtConfig({
  auth: {
    clientOnly: true,
    hubSecondaryStorage: false,
  },
})

Configure secondary storage on the external auth server. If this Nuxt app should run the auth server itself, disable clientOnly and provide a server auth config.

Verify the fix

Run pnpm exec nuxt prepare, then check that sign-in requests still use the intended external auth server.

See Connect to an external auth backend or return to the error reference.