Aller au contenu
Kledg

Utiliser son propre domaine

Faire répondre votre instance Kledg à une adresse comme compta.votre-societe.fr sur Vercel : le domaine, la variable BETTER_AUTH_URL, Revolut et les assistants IA.

Par défaut, votre instance répond à l’adresse que lui donne l’hébergeur, par exemple l’URL de production Vercel en .vercel.app. Vous pouvez lui donner une adresse à votre nom, comme compta.votre-societe.fr : plus facile à retenir, et indépendante de l’hébergeur si vous en changez un jour.

Ce que vous allez faire

  1. Ajouter le domaine au projet Vercel et créer l’enregistrement DNS.
  2. Indiquer la nouvelle adresse à Kledg avec BETTER_AUTH_URL.
  3. Mettre à jour ce qui dépend de l’adresse : Revolut Business et vos assistants IA.

Prérequis

  • Un nom de domaine, et l’accès à sa zone DNS chez votre registraire (OVH, Gandi, Ionos...).
  • L’accès au projet Vercel de votre instance.

Étape 1 : ajouter le domaine sur Vercel

  1. Dans le projet Vercel, ouvrez Settings, puis Domains.
  2. Ajoutez le domaine, par exemple compta.votre-societe.fr.
  3. Vercel indique l’enregistrement DNS à créer (en général un CNAME pour un sous-domaine). Créez-le chez votre registraire.
  4. Attendez que Vercel affiche le domaine comme valide : il crée lui-même le certificat HTTPS.

Étape 2 : définir BETTER_AUTH_URL

  1. Dans Settings, Environment Variables, ajoutez BETTER_AUTH_URL avec l’adresse complète, par exemple https://compta.votre-societe.fr.
  2. Redéployez.

Sans cette variable, Kledg continue d’utiliser l’URL de production Vercel pour ses liens. L’adresse de l’hébergeur reste acceptée pour la connexion.

Étape 3 : mettre à jour ce qui dépend de l’adresse

Kledg construit plusieurs adresses à partir de BETTER_AUTH_URL :

  • Les emails : les liens des invitations et des mots de passe oubliés pointent vers la nouvelle adresse.
  • Revolut Business : l’URL de redirection devient https://compta.votre-societe.fr/api/banking/revolut/callback. Revolut exige l’URL déclarée à l’identique : si vous aviez connecté Revolut avec l’ancienne adresse, déclarez dans Revolut Business l’URL que Kledg affiche désormais (voir Connecter sa banque).
  • Les assistants IA : l’adresse du serveur MCP devient https://compta.votre-societe.fr/api/mcp, celle à donner à vos assistants. La page Assistants IA affiche l’adresse par laquelle vous avez ouvert Kledg : ouvrez-la depuis votre domaine (voir Connecter Claude ou ChatGPT).

Sur les autres hébergeurs

La variable est la même partout : BETTER_AUTH_URL. Railway, Render et Fly.io donnent leur propre adresse à Kledg, et la variable n’est nécessaire qu’avec votre domaine. Sur Clever Cloud, avec Docker Compose et avec Node.js, elle est obligatoire dès l’installation. Chaque hébergeur a sa façon d’ajouter un domaine : voir son guide depuis Choisir son hébergement.

Les erreurs fréquentes

  • Oublier de redéployer après avoir ajouté BETTER_AUTH_URL : la variable n’est lue qu’au démarrage.
  • Mettre http:// au lieu de https://.
  • Garder l’ancienne URL de redirection dans Revolut : la connexion Revolut échoue au prochain consentement.

Pour aller plus loin

Cette documentation aide à comprendre et à utiliser Kledg. Elle ne remplace pas les conseils d’un expert-comptable : en cas de doute sur votre situation, faites-vous accompagner.