> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lekalao.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> Toutes les variables d'environnement de Lekalao.

Lekalao se règle par le fichier `.env`. Les valeurs par défaut sont dans `config/lekalao.php`. Après chaque changement :

```bash theme={null}
php artisan config:cache
php artisan horizon:terminate
```

Les réglages propres à chaque équipe (nom, expéditeur, adresse postale, fournisseurs, domaines, charte) se font dans l'interface, pas ici.

## Laravel

Les variables habituelles de Laravel s'appliquent. Celles qui comptent pour Lekalao :

| Variable                        | Rôle                                                                                                                                                                                                        |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `APP_URL`                       | Adresse publique de l'installation. Base de tous les liens envoyés, sauf si une équipe règle son **URL publique**.                                                                                          |
| `APP_KEY`                       | Clé de chiffrement. À sauvegarder.                                                                                                                                                                          |
| `APP_LOCALE`                    | Langue par défaut : `fr` ou `en`. Langue des messages de l'API et des e-mails de Lekalao pour qui n'a pas choisi.                                                                                           |
| `DB_*`                          | PostgreSQL.                                                                                                                                                                                                 |
| `QUEUE_CONNECTION`              | `redis` en production.                                                                                                                                                                                      |
| `REDIS_QUEUE_RETRY_AFTER`       | 3 660 secondes par défaut. Doit rester **plus long que la tâche la plus longue** (un import, une heure), sinon une tâche encore en cours est confiée à un second worker et un e-mail peut partir deux fois. |
| `CACHE_STORE`, `SESSION_DRIVER` | `redis` conseillé.                                                                                                                                                                                          |
| `MAIL_*`                        | E-mails de Lekalao (invitations, mots de passe) quand aucune équipe n'a de fournisseur par défaut.                                                                                                          |
| `FILESYSTEM_DISK`, `AWS_*`      | Stockage des fichiers ; les médias sont sur le disque `public`.                                                                                                                                             |

## Envoi

### Sécurité d'envoi

| Variable                            | Défaut  | Rôle                                                                                                                                                                                                                      |
| ----------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `LEKALAO_REQUIRE_VERIFIED_DOMAIN`   | `false` | L'expéditeur doit être sur un domaine ajouté **et vérifié** par l'équipe. **À activer sur toute installation qui accueille plusieurs clients.** Voir [Sécurité](/fr/self-hosting/security#qui-peut-ecrire-au-nom-de-qui). |
| `LEKALAO_AUTO_PAUSE_AFTER`          | `500`   | Nombre d'e-mails envoyés avant que les taux ne soient surveillés.                                                                                                                                                         |
| `LEKALAO_AUTO_PAUSE_COMPLAINTS`     | `0.1`   | Taux de plaintes (en %) qui met une campagne en pause.                                                                                                                                                                    |
| `LEKALAO_AUTO_PAUSE_MIN_COMPLAINTS` | `3`     | Nombre minimum de plaintes pour que le taux compte.                                                                                                                                                                       |
| `LEKALAO_AUTO_PAUSE_BOUNCES`        | `5.0`   | Taux de rebonds (en %) qui met une campagne en pause.                                                                                                                                                                     |
| `LEKALAO_AUTO_PAUSE_MIN_BOUNCES`    | `10`    | Nombre minimum de rebonds pour que le taux compte.                                                                                                                                                                        |

Les débits par messagerie de destination (Gmail 300 par minute, Outlook 200, Orange 120, 600 pour les autres…) sont dans `config/lekalao.php`, clé `sending.recipient_limits`. Voir [Sécurité d'envoi](/fr/deliverability/sending-safety).

### Relais SMTP

| Variable                 | Défaut  | Rôle                                                   |
| ------------------------ | ------- | ------------------------------------------------------ |
| `LEKALAO_SMTP_ADVERTISE` | `false` | Affiche le relais dans **Paramètres → Documentation**. |
| `LEKALAO_SMTP_HOST`      |         | Hôte annoncé aux équipes.                              |
| `LEKALAO_SMTP_PORT`      | `2525`  | Port annoncé.                                          |

Le relais lui-même se lance avec ses propres options : voir [Processus](/fr/self-hosting/processes#le-relais-smtp).

## API

| Variable                 | Défaut | Rôle                                               |
| ------------------------ | ------ | -------------------------------------------------- |
| `LEKALAO_API_PER_MINUTE` | `120`  | Appels par minute par jeton. `0` retire la limite. |

## Médias

| Variable                | Défaut | Rôle                                                          |
| ----------------------- | ------ | ------------------------------------------------------------- |
| `LEKALAO_MEDIA_CDN_URL` |        | Sert les images depuis un CDN : mêmes chemins, autre adresse. |

## Données

| Variable                                | Défaut | Rôle                                                                                                                     |
| --------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------ |
| `LEKALAO_PURGE_KEEP_DAYS`               | `365`  | Détail des ouvertures, clics, e-mails transactionnels et appels de webhooks gardés. Les compteurs des campagnes restent. |
| `LEKALAO_WEBHOOK_KEEP_DAYS`             | `30`   | Appels reçus des fournisseurs gardés.                                                                                    |
| `LEKALAO_ERASE_UNSUBSCRIBED_AFTER_DAYS` | `0`    | Oublier les désabonnés après ce délai, pour les équipes qui n'ont rien réglé. `0` : jamais.                              |
| `LEKALAO_CONSENT_LOG_DAYS`              | `1825` | Durée de conservation des preuves de consentement, pour les équipes qui n'ont rien réglé.                                |
| `LEKALAO_ATTRIBUTION_DAYS`              | `14`   | Fenêtre d'attribution d'une vente à un e-mail.                                                                           |

## Inscriptions, facturation, licence

| Variable                                                     | Défaut                | Voir                                                 |
| ------------------------------------------------------------ | --------------------- | ---------------------------------------------------- |
| `LEKALAO_SIGNUP_ENABLED`                                     | `false`               | [Mode service en ligne](/fr/self-hosting/cloud-mode) |
| `LEKALAO_SIGNUP_PLAN`                                        | `starter`             |                                                      |
| `LEKALAO_SIGNUP_TRIAL_DAYS`                                  | `0`                   |                                                      |
| `LEKALAO_BILLING_ENABLED`                                    | `false`               |                                                      |
| `LEKALAO_BILLING_GATEWAY`                                    | `manual`              |                                                      |
| `LEKALAO_BILLING_CURRENCY`                                   | `XAF`                 |                                                      |
| `LEKALAO_BILLING_GRACE_DAYS`                                 | `7`                   |                                                      |
| `WAJUB_SECRET_KEY`, `WAJUB_WEBHOOK_SECRET`, `WAJUB_BASE_URL` |                       |                                                      |
| `LEKALAO_LICENCE_REQUIRED`                                   | `false`               | [Licence](/fr/self-hosting/licence)                  |
| `LEKALAO_LICENCE_PUBLIC_KEY`                                 |                       |                                                      |
| `LEKALAO_LICENCE_SERVER`                                     | `https://lekalao.app` |                                                      |
| `LEKALAO_LICENCE_SIGNING_KEY`                                |                       |                                                      |

## Langues de l'interface

`config/lekalao.php`, clé `locales` : les langues proposées aux utilisateurs. Chacune a son fichier `lang/{code}.json`. Les langues des **abonnés**, elles, ne sont pas limitées : voir [Langues](/fr/content/languages).
