.env Configuration

.env Configuration

The .env file is where you define all of the environment-specific variables for your ElmapiCMS application.


Application Settings

Application Name

This sets the name of your application, which is used in various places like page titles.

APP_NAME=ElmapiCMS

Application URL

This should be the full URL where your application is hosted. It is used to generate asset URLs. For local development, this is typically http://localhost. In production, it should be your public domain (e.g., https://elmapicms.com).

APP_URL=http://localhost

Debug Mode

This should be true in local development to show detailed error messages. For security reasons, this must be set to false in production.

APP_DEBUG=true

Maximum File Size

This sets the maximum size for a single file upload. The value should be in megabytes (e.g., 2M for 2 megabytes).

MAX_FILE_SIZE=2M

Note that this value is also limited by your server's PHP configuration (upload_max_filesize and post_max_size). Your server's setting will take precedence if it is lower than MAX_FILE_SIZE.


Database Configuration

These settings define how your application connects to its database. The actual database and user creation should be handled during your chosen installation (CodeCanyon or GitHub) or deployment process. The variables below should be updated to match the credentials you've set up.

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=elmapi3
DB_USERNAME=root
DB_PASSWORD=

Queue Driver

This setting determines how background jobs, such as sending webhooks, are processed.

QUEUE_CONNECTION=sync
  • sync: (Default) Jobs run immediately in the same process. This is simple for development but can slow down web requests.
  • database: Jobs are stored in the database and processed by a separate queue worker. This is the recommended driver for production environments to ensure webhooks are sent reliably without impacting user experience.

For more information on setting up a queue worker, see the Webhook Setup guide.

Search documentation

Find guides and reference pages