Menu du guide

Chargement…

Rien ne correspond à «  ».

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.