Installation

Install the module

pnpm add @onmax/nuxt-better-auth better-auth

npm install @onmax/nuxt-better-auth better-auth

yarn add @onmax/nuxt-better-auth better-auth

Set Environment Variables

Add these environment variables to .env:

1. Secret Key

A secret value used for encryption and hashing. Must be at least 32 characters with high entropy.

NUXT_BETTER_AUTH_SECRET=

Or generate via terminal:

openssl rand -base64 32

2. Base URL (Optional)

Auto-detected on Vercel, Cloudflare Pages, and Netlify. Set manually for other platforms.

NUXT_PUBLIC_SITE_URL=https://your-domain.com

Configure Nuxt

Add the module to your nuxt.config.ts:

export default defineNuxtConfig({
  modules: ['@onmax/nuxt-better-auth'],
})

Create Configuration Files

Two configuration files connect Nuxt with Better Auth.

1. Server Configuration: server/auth.config.ts
2. Client Configuration: app/auth.config.ts

Create these two configuration files:

import { defineServerAuth } from '@onmax/nuxt-better-auth'

export default defineServerAuth(() => ({
  emailAndPassword: { enabled: true }
}))

import { createAuthClient } from 'better-auth/vue'

export function createAppAuthClient(baseURL: string) {
  return createAuthClient({ baseURL })
}