Aller au contenu

Déployer Kledg sur Vercel et Neon

Le guide pas à pas pour déployer votre instance Kledg avec le pack de démarrage Vercel, Neon et Resend, de la création de la base au premier compte.

par
Publié le 5 min de lecture

Kledg ne s’utilise pas comme un service en ligne : vous déployez votre propre instance, et vos écritures sont stockées dans votre propre base de données. Le chemin le plus court passe par le pack de démarrage : Vercel pour l’application, Neon pour Postgres et Resend pour les emails.

Ce guide décrit chaque étape. Le README du dépôt fait foi pour les détails propres à chaque version.

Avant de commencer

Il vous faut quatre comptes, que vous pouvez créer au fil de l’eau :

  • GitHub, pour héberger votre dépôt de Kledg ;
  • Vercel, pour exécuter l’application ;
  • Neon, pour la base de données Postgres ;
  • Resend, pour l’envoi des emails.

Un mot sur les coûts : Kledg est gratuit, et les offres gratuites de ces services peuvent suffire pour démarrer avec un petit volume. Vérifiez toutefois leurs conditions : l’offre Hobby de Vercel, par exemple, est réservée à un usage personnel et non commercial.

1. Lancer le déploiement

Depuis la page Auto-hébergement, cliquez sur Déployer sur Vercel. Vercel vous demande de vous connecter, puis :

  • crée un nouveau dépôt dans votre compte GitHub à partir du code de Kledg ;
  • crée le projet Vercel associé ;
  • vous propose de créer une base Neon, reliée automatiquement au projet (variables DATABASE_URL et DATABASE_URL_UNPOOLED).

Resend, pour les emails, n’est pas dans le bouton : tant que son domaine n’est pas vérifié, l’intégration bloquerait le déploiement. Il s’ajoute une fois Kledg en ligne (étape 5).

Pour la base, choisissez la région Frankfurt : les fonctions de Kledg s’exécutent à Francfort, et la latence entre l’application et la base compte pour chaque page.

Dans le même écran (Configuration and Plan), désactivez l’option Auth, cochée par défaut. Elle active Neon Auth, un service de comptes utilisateurs synchronisés dans Postgres. Kledg a déjà sa propre authentification : laissée active, l’option ajoute un service et des tables dont Kledg ne se sert pas.

Sous Installation Plans, choisissez l’offre Free : sans carte bancaire, elle offre 1 Go de stockage par projet, largement de quoi tenir plusieurs années d’écritures d’une petite société. Vous pourrez passer à une offre payante plus tard sans recréer la base.

À l’étape Confirmation, Vercel propose un nom tiré au hasard dans Resource Name, du type neon-copper-prism. Remplacez-le par un nom reconnaissable, comme kledg ou kledg-ma-societe : c’est sous ce nom que la base apparaît dans le tableau de bord Vercel et dans Neon, et vous la retrouverez plus facilement le jour où vous aurez plusieurs bases.

2. Renseigner les variables

Vercel ne vous demande plus que deux valeurs :

VariableValeur
BETTER_AUTH_SECRETSecret aléatoire, qui signe les sessions et protège les accès bancaires enregistrés
ADMIN_EMAILVotre email, le seul autorisé à créer le compte administrateur

Les autres viennent toutes seules : DATABASE_URL de Neon. La synchronisation bancaire quotidienne fonctionne sans CRON_SECRET, et les emails attendront.

Le guide de déploiement de kledg.com génère le secret et vous le donne à copier. Sans lui, une commande suffit, ou le bouton à côté :

openssl rand -base64 32 Générer

ADMIN_EMAIL protège votre instance pendant les quelques minutes qui séparent le déploiement de la création de votre compte : personne d’autre ne peut s’approprier l’instance.

3. Laisser Vercel construire

Le build applique automatiquement les migrations de la base Neon, puis construit l’application. Aucune commande à lancer.

4. Créer le compte administrateur

À la fin du déploiement, Vercel vous renvoie vers kledg.com, qui transmet l’adresse de votre instance au guide de déploiement. Le guide affiche le lien d’installation, /setup?token=…, dont le jeton est calculé dans votre navigateur à partir du secret : il ouvre la création du compte administrateur. Sans le guide, la page Installer Kledg calcule ce lien à partir de l’adresse et du secret.

Si vous utilisez votre propre domaine (par exemple compta.votre-societe.fr), ajoutez-le dans les paramètres Domains du projet Vercel et définissez BETTER_AUTH_URL avec cette adresse.

5. Ajouter les emails

Kledg envoie ses emails (mot de passe oublié, accès des nouveaux membres) par l’intermédiaire de Resend. En attendant, Kledg fonctionne : les emails sont écrits dans les logs, et l’ajout d’un membre affiche un mot de passe temporaire à lui transmettre. Pour les envoyer :

  1. dans le projet Vercel, onglet Storage, ajoutez Resend : acceptez ses conditions d’utilisation, gardez l’offre gratuite et tapez le domaine d’où partiront les emails. Vercel renseigne RESEND_API_KEY ;
  2. ouvrez Domains, ajoutez le domaine et revendiquez-le (claim ownership) : Vercel indique l’enregistrement DNS à créer chez votre registraire ;
  3. renseignez EMAIL_FROM, par exemple Kledg <compta@votre-societe.fr>, puis redéployez.

Mettre à jour votre instance

Le bouton Déployer sur Vercel crée une copie du dépôt Kledg, pas un fork : le bouton « Sync fork » de GitHub n’y est donc pas disponible. Votre copie contient à la place le workflow GitHub Actions Update from Kledg :

  1. chaque lundi, il vérifie si une nouvelle version de Kledg est disponible ;
  2. si c’est le cas, il ouvre dans votre dépôt une pull request « Mise à jour Kledg x.y.z » ;
  3. Vercel construit un aperçu de cette pull request : vérifiez-le ;
  4. fusionnez la pull request : Vercel déploie la nouvelle version et applique les migrations de la base.

Vous pouvez aussi lancer le workflow à la main, depuis l’onglet Actions de votre dépôt : Update from Kledg, puis Run workflow.

Si le réglage Allow GitHub Actions to create and approve pull requests (Settings, Actions, General) est désactivé, le workflow pousse quand même la branche kledg-update et affiche un lien pour ouvrir la pull request en un clic. Activez ce réglage pour que tout soit automatique.

Les autres méthodes (fork avec « Sync fork », mise à jour à la main avec git pull) sont décrites sur la page Auto-hébergement. Avant une mise à jour, une branche Neon et un export FEC vous permettent de revenir en arrière.

Et ensuite ?

Votre instance est en ligne. Il reste à créer votre société et à y reprendre vos données : le guide Importer un FEC dans Kledg explique comment récupérer l’historique de votre ancien logiciel.

Articles liés

Tenir la comptabilité de sa société sur Mac sans logiciel Windows : les options en ligne, l’auto-hébergement, et ce qu’il faut vérifier avant de choisir.
Oui, avec un logiciel open source auto-hébergé. Mais l’hébergement a un coût : Vercel, Neon, Resend ou votre serveur, chiffrés honnêtement.
Ce qu’un assistant IA peut faire pour la comptabilité d’une société, ce qu’il ne peut pas faire, et comment le connecter à vos comptes avec le MCP.