> For the complete documentation index, see [llms.txt](https://l-shop-en.gitbook.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://l-shop-en.gitbook.io/documentation/configuration/basic-app-configuration.md).

# Basic application configuration

The basic configuration is in the **.env** file, which is stored in the root of the application. Each option starts with a new line and has the form *key=value*. In this case, if the value contains whitespace, it must be enclosed in double quotes (for example: *my\_option="Hello, World!"*). More information about this file you can read on the documentation page of the framework.

Below are descriptions of all the options.

#### Application

* **APP\_NAME** - Application Name. Will be displayed on the pages of the store, in letters to users and so on.
* **APP\_ENV** - Environment application. Affects various aspects of system behavior. For most users, the optimal value is production.
* **APP\_KEY** - With this key, the system will encrypt various data.

{% hint style="warning" %}
Never give this key to anyone. Otherwise, the security of the application may be at risk.
{% endhint %}

* **APP\_DEBUG** - Setting this option to true turns on debug mode, false turns it off. The mode is used by developers to debug the application.
* **APP\_LOG\_LEVEL** - The level of application logging. Determines how many logs will be written by the L-Shop.
* **APP\_URL** - Base URL of the application. You must set a value equal to the full address of the L-Shop pages. For example: *<http://l-shop.io>* or *<http://example.com/shop>*.
* **APP\_LOCALE** - Local application. This parameter determines the set of regional parameters, including the language. Locals such as **en** (English) and **ru** (Russian) are supported from the box.

#### Database

* **DB\_CONNECTION** - The name of the database connection. By default, it corresponds to the name of the DBMS.
* **DB\_HOST** - The address of the database server. If the database is installed on the same machine as the site, the address is *127.0.0.1*.
* **DB\_PORT** - Database server port. The default for MySQL is *3306*.
* **DB\_DATABASE** - The name of the system database.
* **DB\_USERNAME** - Database user name.
* **DB\_PASSWORD** - Password for the above database user.
* **DB\_PREFIX** - The prefix of the database tables. Leave as is, if you do not know what it is.
* **DOCTRINE\_CACHE** - A caching driver that will use [Doctrine](https://www.doctrine-project.org/).

#### Tools

* **BROADCAST\_DRIVER** - Message broadcast driver. Not used by the application, leave the value as is.
* **CACHE\_DRIVER** - A caching driver that will use the application as a whole.
* **SESSION\_DRIVER** - The driver that will be used to store user session data.
* **SESSION\_LIFETIME** - The lifetime of the user's session in minutes.
* **QUEUE\_DRIVER** - Driver queues.

#### Redis

* **REDIS\_HOST** - Redis server address.
* **REDIS\_PORT** - Redis server port. The default is *6379*.
* **REDIS\_PASSWORD** - Password to access Redis.

#### Email

* **MAIL\_DRIVER** - The driver used to send messages. It is recommended to use *smtp*.
* **MAIL\_HOST** - SMTP-server address.
* **MAIL\_PORT** - SMTP-server port.
* **MAIL\_USERNAME** - SMTP user name. As a rule, it is the email address of the user of the service.
* **MAIL\_PASSWORD** - SMTP user password. As a rule, they are the password of the user of the service.
* **MAIL\_ENCRYPTION** - Connection encryption protocol. It is recommended to use *tls*.
* **MAIL\_FROM\_ADDRESS** - Address of the author of the letter. Usually, it coincides with MAIL\_USERNAME.
* **MAIL\_FROM\_NAME** - Name of the author of the email.

{% hint style="info" %}
If you use [Gmail](https://support.google.com/a/answer/176600?hl=ru) as an SMTP service, you need to install the checkbox on [this page](https://myaccount.google.com/lesssecureapps?pli=1) to send email correctly.
{% endhint %}