Environment Setup

LaunchSaaS requires several environment variables to function properly. This guide explains how to set them up.

Create a .env file in the root directory of your project, and never commit it to version control.

cp .env.example .env

Environment Variables

Core Configuration

Next.js automatically loads .env.development during development and .env.production for production builds.

Database

Learn how to set up a database in the Database Setup guide.

Authentication

Learn how to set up authentication in the Authentication Setup guide.

Admin User

Email (Optional)

Learn how to set up email in the Email Setup guide.

Newsletter (Optional)

Learn how to set up newsletter in the Newsletter Setup guide.

Payment - Stripe (Optional)

Learn how to set up payments in the Payment Setup guide.

Payment - Creem (Optional)

Learn how to set up Creem in the Payment Setup guide.

Captcha (Optional)

Storage (Optional)

Learn how to set up storage in the Storage Setup guide.

Cache (Optional)

Learn how to set up cache in the Cache Setup guide.

Redis (Standard)

For local Redis or managed Redis services (AWS ElastiCache, Azure Cache, etc.).

Upstash Redis

For Upstash Redis using HTTP REST API (perfect for serverless).

Cloudflare KV

Scheduled Jobs (Optional)

Learn how to set up scheduled jobs in the Scheduled Jobs Setup guide.

Upstash QStash

Analytics (Optional)

GitHub Integration (Optional)

For automatic repository access on payment completion. Enable in packages/config/src/features/development.ts or packages/config/src/features/production.ts.

Feature Configuration

LaunchSaaS uses packages/config/src/features/ to control which providers are enabled:

// packages/config/src/features/development.ts
export const features: Features = {
  email: {
    provider: "resend",
  },
  newsletter: {
    provider: "resend",
  },
  authentication: {
    magicLink: true,
    captcha: {
      enabled: true,
      provider: "cloudflare-turnstile",
    },
    oauths: {
      google: true,
      github: true,
    },
  },
  payment: {
    provider: "stripe", // "stripe" | "creem"
    hooks: {
      github: true, // Enable GitHub integration
      email: true, // Enable payment completion emails
    },
  },
};

packages/config/src/features/index.ts loads production.ts only when NODE_ENV === "production". All other environments use development.ts.

Omit optional sections such as storage, cache, cron, newsletter, or payment when you do not want to enable that feature in the active environment file.

Learn more in the Features Configuration guide.

Verifying Environment Variables

To verify that your environment variables are correctly set up, run:

pnpm run dev

If everything is configured correctly, your application should start without any environment-related errors.

Next Steps