Configuring Environment Variables

To make your deployment production-worthy, you'll need to configure several environment variables, especially for Mail and Stripe integration. Here are the groups of environment variables you'll need:

Frontend Variables

Variable Name	Description	Example
VITE_FRONTEND_URL	Frontend URL	https://your-app.com
VITE_API_URL_CLIENT	API URL for use in the browser	https://your-app.com/api
VITE_API_URL_SERVER	API URL for use on server	This is used for server-side rendering. Usually http://localhost:8000/api
VITE_STRIPE_PUBLISHABLE_KEY	Stripe public key	pk_test_51...

Backend Variables

Mail Configuration

You can use email providers like Postmark, SendGrid, or AWS SES.

Variable Name	Description	Example
MAIL_MAILER	Mail driver	smtp
MAIL_HOST	Mail server host	smtp.mailtrap.io
MAIL_PORT	Mail server port	2525
MAIL_USERNAME	Mail server username	your-username
MAIL_PASSWORD	Mail server password	your-password

For more details on configuring mail settings in Laravel, refer to the Laravel Mail Documentation.

Stripe Configuration

For more information on obtaining Stripe API keys, visit the Stripe API Keys Documentation.

Variable Name	Description	Example
STRIPE_PUBLIC_KEY	Stripe public key	pk_test_51...
STRIPE_SECRET_KEY	Stripe secret key	sk_test_51...
STRIPE_WEBHOOK_SECRET	Stripe webhook secret	whsec_...

General Configuration

Variable Name	Description	Example
APP_KEY	Application key	base64:...
APP_SAAS_MODE_ENABLED	Enable SaaS mode.	true
APP_SAAS_STRIPE_APPLICATION_FEE_PERCENT	Stripe application fee percentage. Only relevant in SAAS mode	1.5
APP_FRONTEND_URL	Frontend URL	https://your-app.com
APP_CDN_URL	CDN URL	https://cdn.your-app.com
APP_DISABLE_REGISTRATION	Disable registration	Disables people from registering new accounts. Suggested for non-SaaS deployments.
FILESYSTEM_PUBLIC_DISK	Filesystem disk	Default: s3-public. local if you're using local disk storage
FILESYSTEM_PRIVATE_DISK	Filesystem disk	Default: s3-private. local if you're using local disk storage
JWT_SECRET	JWT secret key	base64:...
LOG_CHANNEL	Log channel	stderr

The APP_KEY can be generated using the following command:

echo "base64:$(openssl rand -base64 32)"

AWS Configuration

These variables are required if you'd like to use AWS S3 for file storage. You can also use other s3-compatible services like DigitalOcean Spaces.

To avoid losing files during updates or server failures, we highly recommend using cloud file storage for production deployments.

Variable Name	Description	Example
AWS_ACCESS_KEY_ID	AWS access key ID	your-access-key-id
AWS_SECRET_ACCESS_KEY	AWS secret access key	your-secret-access-key
AWS_DEFAULT_REGION	AWS region	us-west-1
AWS_PUBLIC_BUCKET	AWS public bucket name	your-public-bucket
AWS_PRIVATE_BUCKET	AWS private bucket name	your-private-bucket

Database Configuration

You can either set individual database configuration variables or use the DATABASE_URL to simplify the configuration.

Variable Name	Description	Example
DB_CONNECTION	Database connection type	pgsql
DB_HOST	Database host	your-database-host
DB_PORT	Database port	5432
DB_DATABASE	Database name	your-database-name
DB_USERNAME	Database username	your-database-username
DB_PASSWORD	Database password	your-database-password
DATABASE_URL	Database URL (alternative to individual values)	postgres://user:password@host:port/database

Redis Configuration

Variable Name	Description	Example
REDIS_HOST	Redis host	your-redis-host
REDIS_PASSWORD	Redis password	your-redis-password
REDIS_USER	Redis username	your-redis-username
REDIS_PORT	Redis port	6379
REDIS_URL	Redis URL	redis://user:password@host:port

Queue Configuration

Variable Name	Description	Example
QUEUE_CONNECTION	Queue connection type	Default: redis. Set to sync to disable queues and run jobs immediately.