Skip to main content

Configuration Overview

Dashboard Laravel provides comprehensive configuration options to customize your administrative dashboard for different environments and use cases.

Configuration Sections

Settings

Profile, system, and appearance settings

Security

Password, 2FA, and authentication configuration

Notifications

Email and system notification preferences

Quick Configuration

Dashboard Laravel uses Laravel’s standard .env file for environment-specific configuration. All settings are centralized in the config/ directory.

Essential Configuration Files

Configure your PostgreSQL connection in .env:
DB_CONNECTION=pgsql
DB_HOST=127.0.0.1
DB_PORT=5432
DB_DATABASE=dashboard_db
DB_USERNAME=postgres
DB_PASSWORD=your_password
Defined in config/database.php
Set your application environment:
APP_NAME="Dashboard Laravel"
APP_ENV=local
APP_KEY=base64:your_generated_key_here
APP_DEBUG=true
APP_TIMEZONE=UTC
APP_URL=http://localhost
Defined in config/app.php
Manage user sessions:
SESSION_DRIVER=database
SESSION_LIFETIME=120
SESSION_ENCRYPT=false
SESSION_PATH=/
SESSION_DOMAIN=null
Defined in config/session.php
Configure email notifications:
MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=2525
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="[email protected]"
MAIL_FROM_NAME="${APP_NAME}"
Defined in config/mail.php

Configuration by Environment

Development Environment

For local development:
APP_ENV=local
APP_DEBUG=true
LOG_LEVEL=debug
Debug mode shows detailed error messages. Never enable in production.

Production Environment

For production deployment:
APP_ENV=production
APP_DEBUG=false
LOG_LEVEL=error
Always disable debug mode and set appropriate log levels in production.

Configuration Caching

Laravel caches configuration files for better performance:
# Cache configuration
php artisan config:cache

# Clear cached configuration
php artisan config:clear
Changes to .env or config files require clearing the cache in production.

User Interface Configuration

The dashboard includes a visual configuration interface at /configuracion:
1

Access Settings

Navigate to the settings page using the sidebar menu or visit /configuracion
2

Choose Configuration Tab

Switch between Profile, Security, Notifications, and System tabs
3

Update Settings

Modify your preferences and save changes
4

Verify Changes

Check that your configuration updates are applied correctly

Configuration Options

Profile Settings

  • Personal information
  • Regional preferences
  • Display language
  • Timezone settings

Security Settings

  • Password management
  • Two-factor authentication (2FA)
  • Session timeout
  • Login notifications

Notification Settings

  • Email preferences
  • System alerts
  • Weekly reports
  • Message notifications

System Settings

  • Application name
  • Version display
  • Maintenance mode
  • Debug options

Environment Variables Reference

Key environment variables used by Dashboard Laravel:
VariableDescriptionDefault
APP_NAMEApplication nameDashboard Laravel
APP_ENVEnvironment (local/production)local
APP_DEBUGDebug mode (true/false)true
APP_URLApplication URLhttp://localhost
DB_CONNECTIONDatabase driverpgsql
DB_DATABASEDatabase namedashboard_db
SESSION_DRIVERSession storagedatabase
MAIL_MAILERMail driversmtp

Next Steps

Installation Guide

Set up your environment and install dependencies

Security Configuration

Configure authentication and security features

Notification Setup

Set up email and system notifications

Settings Reference

Explore all available settings

Build docs developers (and LLMs) love