Configuration

Customize AuthCore to fit your application's needs.

Environment Variables

Complete list of environment variables you can configure:

.env

Required Variables

  • DATABASE_URL - Database connection string
  • NEXTAUTH_SECRET - Secret for JWT encryption
  • NEXTAUTH_URL - Your application URL

Optional Variables

  • EMAIL_SERVER - SMTP server for emails
  • WEBHOOK_SECRET - Secret for webhook verification
  • ENABLE_2FA - Enable two-factor authentication

NextAuth Configuration

Customize session behavior, callbacks, and pages:

lib/auth-config.ts

Security Settings

Configure security features programmatically or via the admin UI:

configure-security.ts

Tip: You can also manage these settings through the SecuritySettings component in your admin dashboard.

Email Templates

Customize email templates for verification, password reset, and invites:

config/email-templates.ts

Custom Styling

Override default styles using Tailwind CSS:

tailwind.config.js

Database Providers

AuthCore supports multiple database providers through Prisma:

MySQL

Recommended for production

mysql://user:pass@host:3306/db

PostgreSQL

Great for complex queries

postgresql://user:pass@host:5432/db

SQLite

Perfect for development

file:./dev.db

Feature Flags

Enable or disable features using environment variables:

FlagDefaultDescription
ENABLE_2FAtrueEnable two-factor authentication
ENABLE_EMAIL_VERIFICATIONtrueRequire email verification on signup
ENABLE_WAITLISTfalseEnable waitlist mode for signups
ENABLE_ORGANIZATIONStrueEnable organization/team features

Advanced Configuration

Security Configuration →

Lockout policies, restrictions, and attack protection

Webhook Configuration →

Set up webhooks for user events and organization changes

Styling Guide →

Learn how to customize the look and feel

Billing Configuration →

Set up subscriptions and payment processing

Email Setup Guide →

Configure SMTP, service shortcuts, and Render-friendly deployments