MkSaaS DocsEnvironment Setup
Configure environment variables for your MkSaaS application
MkSaaS requires several environment variables to function properly, and 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.
You can copy the example file as a starting point:
cp env.example .envEnvironment Variables
Core Configuration
| Variable | Description |
|---|---|
| NEXT_PUBLIC_BASE_URL | The public URL of your site, e.g. http://localhost:3000 for development, https://=YOUR-DOMAIN.com for production |
Database
Learn how to set up a database in the Database Setup guide.
| Variable | Description |
|---|---|
| DATABASE_URL | Database connection URL |
Authentication
Learn how to set up authentication in the Authentication Setup guide.
| Variable | Description |
|---|---|
| BETTER_AUTH_SECRET | A random string used to hash tokens and sign cookies |
| GOOGLE_CLIENT_ID | Google OAuth client ID (optional) |
| GOOGLE_CLIENT_SECRET | Google OAuth client secret (optional) |
| GITHUB_CLIENT_ID | GitHub OAuth client ID (optional) |
| GITHUB_CLIENT_SECRET | GitHub OAuth client secret (optional) |
Learn how to set up email in the Email Setup guide.
| Variable | Description |
|---|---|
| RESEND_API_KEY | API key for Resend email service |
Newsletter
Learn how to set up newsletter in the Newsletter Setup guide.
| Variable | Description |
|---|---|
| RESEND_API_KEY | API key for Resend email service |
Storage
Learn how to set up storage in the Storage Setup guide.
| Variable | Description |
|---|---|
| STORAGE_REGION | Region for the storage bucket |
| STORAGE_BUCKET_NAME | Name of the storage bucket |
| STORAGE_ACCESS_KEY_ID | Access key ID for the storage bucket |
| STORAGE_SECRET_ACCESS_KEY | Secret access key for the storage bucket |
| STORAGE_ENDPOINT | Endpoint for the storage bucket |
| STORAGE_PUBLIC_URL | Public URL for the storage bucket |
Payment
Learn how to set up payments in the Payment Setup guide.
| Variable | Description |
|---|---|
| STRIPE_SECRET_KEY | Stripe secret key |
| STRIPE_WEBHOOK_SECRET | Stripe webhook signing secret |
| NEXT_PUBLIC_STRIPE_PRICE_PRO_MONTHLY | Stripe price ID for pro monthly subscription |
| NEXT_PUBLIC_STRIPE_PRICE_PRO_YEARLY | Stripe price ID for pro yearly subscription |
| NEXT_PUBLIC_STRIPE_PRICE_LIFETIME | Stripe price ID for lifetime subscription |
Credits
Learn how to set up credits in the Credits Setup guide.
| Variable | Description |
|---|---|
| NEXT_PUBLIC_STRIPE_PRICE_CREDITS_BASIC | Stripe price ID for basic credit package (optional) |
| NEXT_PUBLIC_STRIPE_PRICE_CREDITS_STANDARD | Stripe price ID for standard credit package (optional) |
| NEXT_PUBLIC_STRIPE_PRICE_CREDITS_PREMIUM | Stripe price ID for premium credit package (optional) |
| NEXT_PUBLIC_STRIPE_PRICE_CREDITS_ENTERPRISE | Stripe price ID for enterprise credit package (optional) |
Cron Jobs
Learn how to set up cron jobs in the Cron Jobs Setup guide.
| Variable | Description |
|---|---|
| CRON_JOBS_USERNAME | Username for basic authentication to trigger cron jobs |
| CRON_JOBS_PASSWORD | Password for basic authentication to trigger cron jobs |
AI Features
Learn how to set up AI features in the AI Setup guide.
| Variable | Description |
|---|---|
| OPENAI_API_KEY | API key for OpenAI |
| FAL_API_KEY | API key for FAL |
| FIREWORKS_API_KEY | API key for Fireworks |
| REPLICATE_API_TOKEN | API key for Replicate |
| GOOGLE_GENERATIVE_AI_API_KEY | API key for Google Generative AI |
| DEEPSEEK_API_KEY | API key for DeepSeek |
| OPENROUTER_API_KEY | API key for OpenRouter |
Analytics
Learn how to set up analytics in the Analytics Setup guide.
| Variable | Description |
|---|---|
| NEXT_PUBLIC_GOOGLE_ANALYTICS_ID | Google Analytics ID |
| NEXT_PUBLIC_UMAMI_WEBSITE_ID | Umami Analytics website ID |
| NEXT_PUBLIC_UMAMI_SCRIPT | Umami Analytics script URL |
| NEXT_PUBLIC_PLAUSIBLE_DOMAIN | Plausible Analytics domain |
| NEXT_PUBLIC_PLAUSIBLE_SCRIPT | Plausible Analytics script URL |
| NEXT_PUBLIC_DATAFAST_WEBSITE_ID | DataFast Analytics ID |
| NEXT_PUBLIC_DATAFAST_DOMAIN | DataFast Analytics domain |
| NEXT_PUBLIC_POSTHOG_KEY | PostHog Analytics key |
| NEXT_PUBLIC_POSTHOG_HOST | PostHog Analytics host |
| NEXT_PUBLIC_AHREFS_WEBSITE_ID | Ahrefs Analytics website ID |
| NEXT_PUBLIC_Seline_TOKEN | Seline Analytics token |
| NEXT_PUBLIC_OPENPANEL_CLIENT_ID | OpenPanel Analytics client ID |
| NEXT_PUBLIC_CLARITY_PROJECT_ID | Clarity Analytics project ID |
Notification
Learn how to set up notification in the Notification Setup guide.
| Variable | Description |
|---|---|
| DISCORD_WEBHOOK_URL | Discord webhook URL for receiving notifications of successful payments |
| FEISHU_WEBHOOK_URL | Feishu webhook URL for receiving notifications of successful payments |
Captcha
Learn how to set up captcha in the Captcha Setup guide.
| Variable | Description |
|---|---|
| NEXT_PUBLIC_TURNSTILE_SITE_KEY | Turnstile site key |
| TURNSTILE_SECRET_KEY | Turnstile secret key |
Chatbox
Learn how to set up chatbox in the Chatbox Setup guide.
| Variable | Description |
|---|---|
| NEXT_PUBLIC_CRISP_WEBSITE_ID | Crisp website ID for chat features |
Affiliates
Learn how to set up affiliates in the Affiliates Setup guide.
| Variable | Description |
|---|---|
| NEXT_PUBLIC_AFFILIATE_AFFONSO_ID | Affonso affiliate ID |
| NEXT_PUBLIC_AFFILIATE_PROMOTEKIT_ID | Promotekit affiliate ID |
Other Configurations
Some other configurations are also available in the .env file, you may need to set them up depending on your needs.
| Variable | Description |
|---|---|
| DISABLE_IMAGE_OPTIMIZATION | Disable image optimization, if you deploy your website to Vercel, image optimization is enabled by default, and may cost you more money |
| NEXT_PUBLIC_DEMO_WEBSITE | Run this website as demo website, I use this for MkSaaS demo website. In most cases, you should not set this or leave it to false |
Verifying Environment Variables
To verify that your environment variables are correctly set up, run:
pnpm run devnpm run devyarn devbun run devIf everything is configured correctly, your application should start and run normally without any environment-related errors.
Video Tutorial
Next Steps
Now that your environment is set up, explore these related topics: