# App

 The application configuration can be further fine-tuned outside the operator panel. These items exist as environment variables as their default values are OK for most users, but allow advanced users to better control the application.

For details on how to set the below configuration items, please read [Environment Variables](Updating+Config+Files#EnvironmentVariables).

## Email Processing

   Environment Variable Name Description Valid values Default   `EMAIL_VERIFY_PEER` Whether to verify the peer SSL certificate when sending emails. ```
boolean
```

 ```
false
```

   `EMAIL_VERIFY_PEER_NAME` Whether to verify the peer name when sending emails. ```
boolean
```

 ```
false
```

   `EMAIL_ALLOW_SELF_SIGNED` Whether to allow self-signed certificates when sending emails. ```
boolean
```

 ```
true
```

   `EMAIL_TOGGLE_QUOTES` Whether to hide quoted parts of inbound emails, they will be wrapped in \[ ... \] and show/hide when clicked in the operator ticket view. ```
boolean
```

 ```
true
```

   `EMAIL_MACRO_START_CHAR` Character sequence used to identify the start of an [Email Command](Email+Commands). ```
string
```

 ```
{%
```

   `EMAIL_MACRO_END_CHAR` Character sequence used to identify the end of an [Email Command](Email+Commands). ```
string
```

  ```
%}
```

  ## Logging

   Environment Variable Name Description Valid values   `LOG_STACK_CHANNELS` A comma delimited list of log channels. **Do not separate comma delimited items with whitespace.** ```
generallog, slack, stderr, syslog
```

   `LOG_SLACK_WEBHOOK_URL` A slack webhook URL, see [Slack documentation](https://api.slack.com/messaging/webhooks). ```
string
```

   `LOG_MAX_FILES` The number of log files to retain. ```
integer
```

   `LOG_LEVEL` Log all levels greater than or equal to the specified severity level. For example, a log\_level of `error` will log `error`, `critical`, `alert`, and `emergency` messages. ```
debug, info, notice, warning,
```

```
error, critical, alert, emergency
```

  ## Outbound Mail

### SMTP Settings

   Environment Variable Name Description Valid Value(s)   `MAIL_LOCAL_DOMAIN` Used in the EHLO/HELO statement sent to the mail server. It defaults to the server name, or `[127.0.0.1]` when the server name is not available (such as on the CLI).

  `null`, domain or IP   `MAIL_TIMEOUT` The number of seconds that the system should wait for a response from the mail server before timing out.

  int  ### Reply Line

All outbound ticket emails have a reply-above-line prepended to the start of the email, this enables the email parser to clip replies.

   Environment Variable Name Description Valid Value(s)   `MAIL_DELIMITER` Character sequence wrapped around "Please respond above this line" message added to the start of all ticket emails. Used to identify the end of replies via email by searching for a HTML node that starts and ends with the specified character sequence.

**Take extreme care when editing as replies via the email channel may not be clipped or may be clipped incorrectly.**

  alphanumeric, dashes, hashes, exclamation marks   `MAIL_REPLY_LINE` The "Please reply above this line" message added to the start of ticket emails generated by SupportPal.

The %s inside a HTML node is **REQUIRED** for clipping replies via email. It is automatically replaced by mail.delimiter Please reply above this line mail.delimiter. The language variable can be found in addons/Languages/\*/Lang/\*/ticket.php under key "reply\_above\_line".

Set to an empty string to completely remove the reply line; this means replies via the email channel will not be clipped.

  ```
<em style="color: #999;">%s</em><br /><br />
```

  ## System Cleanup

   Environment Variable Name Description Valid values Default   `EMPTY_TICKET_TRASH` The number of days after which tickets in the trash are deleted permanently automatically, counts from when the ticket was moved to the trash. ```
integer
```

 ```
30
```

   `RAW_EMAIL_EXPIRY_DAYS` The number of days that raw email log files are stored on the file system. Emails from pre-2.4.0 are stored in the database and must be pruned via the [System Cleanup](System+Cleanup#Logs) tool. ```
integer
```

 ```
30
```

  ## User Interface

   Environment Variable Name Description Valid values Default   `2FA_NAME` The default account name that shows when setting up 2FA. ```
string
```

 ```
SupportPal
```

   `LDAP_DUAL_LOGIN` If operators can log in with their regular operator login as well as their LDAP account. ```
bool
```

 ```
false
```

   `TOTAL_SELFSERVICE_ARTICLES` The number of articles to show per category in the self-service by default, for 'hierarchical' types only. ```
integer
```

 ```
3
```

   `TOTAL_VISIBLE_RECIPIENTS` The total number of recipients that should be visible when viewing the e-mail log. If there are more addresses, "and x others" will be shown. ```
integer
```

 ```
2
```

   `ENABLE_TIMEAGO` Can be used to disable the relative times (e.g. '1 hour ago') throughout the system. ```
bool
```

 ```
true
```

   `OPERATOR_TOTAL_RECENT_TICKETS` Change the total number of recently viewed tickets that are displayed in the operator panel navigation. Set to `0` to disable. ```
integer
```

 ```
3
```

   `OPERATOR_TOTAL_RECENT_FILTERS` Change the total number of recently viewed filters that are displayed in the operator panel navigation. Set to `0` to disable. ```
integer
```

 ```
3
```

   `OPERATOR_TOTAL_RECENT_USERS` Change the total number of recently viewed users that are displayed in the operator panel navigation. Set to `0` to disable. ```
integer
```

 ```
3
```

   `OPERATOR_TOTAL_RECENT_ORGANISATIONS` Change the total number of recently viewed organisations that are displayed in the operator panel navigation. Set to `0` to disable. ```
integer
```

 ```
3
```

  ### Ticket Messages

   Environment Variable Name Description Valid values Default   `MESSAGE_LOAD_INITIAL`  The number of messages to initially load when you view a ticket. If the ticket has more unread messages than this number, the system will load up to `MESSAGE_LOAD_LIMIT` instead. Use a low value to avoid initially loading a large number of messages you’ve already read.  
   
  *The maximum value allowed is `50`. **Note**: higher values may cause performance issues on long tickets or with very large messages.*   ```
integer
```

 ```
2
```

   `MESSAGE_LOAD_LIMIT`  Controls how many older messages are loaded each time you click the "x older messages" button (the per-page pagination size).  
   
  *The maximum value allowed is `50`. **Note**: higher values may cause performance issues on long tickets or with very large messages.*   ```
integer
```

 ```
20
```

   `MESSAGE_MAX_SIZE`  Messages that are greater than this size in bytes will be truncated. The original message can be viewed by clicking the "View entire message" link at the bottom of the message.  
   
 **Note:** higher values may cause performance issues on tickets or with very large messages.  ```
integer (bytes)
```

 ```
102000
```

  ## Miscellaneous

   Environment Variable Name Description Valid values Default   `DATATABLES_SKIP_COUNT`  The default pagination performs a total record count, which can be slow on large installations. Enabling this option will switch to a simpler form of pagination, using only "Next" and "Previous" buttons. This change can improve page load performance by up to 50%.  ```
bool
```

 ```
false
```

   `FORCE_DISABLE_SSL`  Disable SSL redirection middleware.  
 *Use only when Enable SSL is toggled on in SupportPal and HTTPS connections are broken.*  ```
bool
```

 ```
false
```

   `LDAP_TIMEOUT` The number of seconds to wait before timing out the connection to the LDAP server. ```
integer
```

 ```
5
```