Deploy hi.events on Railway

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.