Configuration
Obole lit ses réglages dans .env. Après une modification, recréez les conteneurs avec docker compose up -d pour que les trois lisent les nouvelles valeurs.
L’application
| Réglage | Ce que c’est |
|---|---|
APP_URL |
L’adresse d’Obole, en HTTPS, telle que vos clients la verront dans les liens de paiement et de signature |
APP_KEY |
La clé de l’application, générée une fois à l’installation |
OBOLE_LICENSE_KEY |
Votre clé de licence, qui commence par OBL- |
OBOLE_LICENSE_SERVER |
Le serveur de licences ; sans ce réglage, https://account.laibe.cc. Vous n’avez pas à l’ajouter |
OBOLE_VERSION |
Le tag de l’image que vous faites tourner, comme 2026.11.17 |
L’e-mail
Obole envoie vos factures et vos devis, les relances de paiement, les rappels d’échéances et un point hebdomadaire sur votre comptabilité. Tout service SMTP convient :
| Réglage | Ce que c’est |
|---|---|
MAIL_HOST, MAIL_PORT |
Votre serveur SMTP, en général sur le port 587 |
MAIL_USERNAME, MAIL_PASSWORD |
Ses identifiants |
MAIL_FROM_ADDRESS, MAIL_FROM_NAME |
L’expéditeur des e-mails |
La synchronisation bancaire
Obole récupère vos opérations par GoCardless Bank Account Data, avec votre propre compte. Créez des identifiants dans ce compte, puis :
| Réglage | Ce que c’est |
|---|---|
GOCARDLESS_SECRET_ID |
L’identifiant du secret |
GOCARDLESS_SECRET_KEY |
La clé du secret |
La liste des banques se met à jour chaque dimanche. Pour l’avoir tout de suite après avoir ajouté ces réglages :
docker compose exec web php artisan banks:import-institutions
Vous connectez ensuite votre banque depuis Paramètres, et Obole vous prévient quand il faut renouveler votre accord auprès d’elle. Sans ces réglages, vous importez vos relevés bancaires en CSV.
Le paiement par carte
Pour que vos clients paient vos factures par carte, Obole crée des liens de paiement avec votre propre compte Stripe :
| Réglage | Ce que c’est |
|---|---|
STRIPE_SECRET |
La clé secrète de votre compte Stripe |
STRIPE_WEBHOOK_SECRET |
Le secret de signature du webhook ci-dessous |
Dans Stripe, ajoutez un webhook vers https://compta.example.fr/webhooks/stripe (votre APP_URL suivi de /webhooks/stripe) avec l’événement checkout.session.completed, pour qu’Obole enregistre le paiement sur la facture. Sans ces réglages, la facture propose un virement SEPA avec un QR code.