Configuration

Environment Variables

Exowpee uses a .env file for configuration. Copy .env.example to get started:

cp .env.example .env

Application Settings

Variable	Default	Description
`APP_NAME`	`Exowpee`	Application name (used in emails, logs)
`APP_ENV`	`local`	Environment: `local`, `staging`, `production`
`APP_KEY`	-	Encryption key (generate with `php artisan key:generate`)
`APP_DEBUG`	`true`	Show detailed errors. Set to `false` in production
`APP_TIMEZONE`	`UTC`	Server timezone
`APP_URL`	`http://localhost`	Base URL for the application
`APP_LOCALE`	`en`	Default language (`en` or `fr`)
`APP_FALLBACK_LOCALE`	`en`	Fallback language

Database (PostgreSQL)

Variable	Default	Description
`DB_CONNECTION`	`pgsql`	Database driver. Always `pgsql` for Exowpee
`DB_HOST`	`127.0.0.1`	Database host (`db` if using Docker)
`DB_PORT`	`5432`	PostgreSQL port
`DB_DATABASE`	`exowpee`	Database name
`DB_USERNAME`	`root`	Database user
`DB_PASSWORD`	-	Database password

Authentication (JWT & Sanctum)

Variable	Default	Description
`JWT_SECRET`	-	JWT signing secret (generate with `php artisan jwt:secret`)
`SANCTUM_STATEFUL_DOMAINS`	`localhost`	Domains for stateful Sanctum auth

Cache & Session

Variable	Default	Description
`CACHE_STORE`	`database`	Cache driver: `database`, `redis`, `file`
`SESSION_DRIVER`	`database`	Session driver
`SESSION_LIFETIME`	`120`	Session timeout in minutes

Queue

Variable	Default	Description
`QUEUE_CONNECTION`	`database`	Queue driver: `database`, `redis`, `sync`

Named queues used by Exowpee:

client_refresh — Real-time UI update broadcasts
default — General background jobs

Broadcasting (Reverb WebSockets)

Variable	Default	Description
`BROADCAST_CONNECTION`	`reverb`	Broadcasting driver
`REVERB_APP_ID`	-	Reverb application ID
`REVERB_APP_KEY`	-	Reverb public key
`REVERB_APP_SECRET`	-	Reverb secret key
`REVERB_HOST`	`localhost`	Reverb server host
`REVERB_PORT`	`8080`	Reverb server port
`REVERB_SCHEME`	`http`	Protocol (`http` or `https`)

Mail

Variable	Default	Description
`MAIL_MAILER`	`log`	Mail driver: `smtp`, `log`, `mailgun`, etc.
`MAIL_HOST`	-	SMTP host
`MAIL_PORT`	`587`	SMTP port
`MAIL_USERNAME`	-	SMTP username
`MAIL_PASSWORD`	-	SMTP password
`MAIL_FROM_ADDRESS`	-	Default sender email

Configuration Files

Configuration files live in config/ and can be cached for production:

php artisan config:cache    # Cache all config (production)
php artisan config:clear    # Clear config cache (development)

Key configuration files

config/auth.php — Authentication guards Exowpee uses multiple authentication guards:

Guard	Driver	Purpose
`api`	`exowpee-jwt`	Main user JWT authentication
`agent`	`exowpee-agent-jwt`	Agent authentication (limited-access employees)
`sanctum`	`sanctum`	Stateful web authentication

config/scramble.php — API Documentation Configures automatic OpenAPI specification generation via Scramble. config/telescope.php — Debugging Laravel Telescope configuration for local debugging. Only active when APP_ENV=local.

Production configuration

For production deployments, always:

Set APP_ENV=production and APP_DEBUG=false
Cache configuration: php artisan config:cache
Cache routes: php artisan route:cache
Use Redis for cache and queue instead of database
Configure proper SMTP for mail
Set REVERB_SCHEME=https for secure WebSockets

Getting started

Architecture

Developer guide

Operations

More

Configuration

Environment Variables

Application Settings

Database (PostgreSQL)

Authentication (JWT & Sanctum)

Cache & Session

Queue

Broadcasting (Reverb WebSockets)

Mail

Configuration Files

Key configuration files

Production configuration

​Environment Variables

​Application Settings

​Database (PostgreSQL)

​Authentication (JWT & Sanctum)

​Cache & Session

​Queue

​Broadcasting (Reverb WebSockets)

​Mail

​Configuration Files

​Key configuration files

​Production configuration

Environment Variables

Application Settings

Database (PostgreSQL)

Authentication (JWT & Sanctum)

Cache & Session

Queue

Broadcasting (Reverb WebSockets)

Mail

Configuration Files

Key configuration files

Production configuration