Déployer Kledg sur Vercel et Neon

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.

Les fonctions d’IA sont optionnelles et passent par Vercel AI Gateway, facturé à l’usage sur votre compte Vercel.

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).

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.

2. Renseigner les variables

Vercel vous demande ensuite quelques valeurs :

Pour générer un secret robuste, une commande suffit :

openssl rand -base64 32

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

Ouvrez l’URL de votre instance : vous arrivez sur la page de configuration. Créez le compte administrateur avec l’email défini dans ADMIN_EMAIL. C’est depuis ce compte que vous créerez votre société et donnerez accès aux membres de votre équipe.

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. Configurer Resend

Kledg envoie ses emails (mot de passe oublié, accès des nouveaux membres) par l’intermédiaire de Resend. Dans Resend :

1. ajoutez et vérifiez le domaine depuis lequel partiront les emails ;
2. créez une clé API avec la permission d’envoi, qui sera la valeur de RESEND_API_KEY ;
3. choisissez l’adresse d’expédition, par exemple compta@votre-societe.fr, qui sera la valeur de EMAIL_FROM.

Renseignez ces deux variables dans le projet Vercel, puis redéployez. 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.

Les fonctions d’IA, elles, n’ont besoin d’aucune configuration sur Vercel : elles passent par Vercel AI Gateway, authentifié automatiquement.

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.

Pour les mises à jour, il suffit de récupérer les nouveaux commits du dépôt Kledg dans votre dépôt : Vercel redéploie automatiquement. La page Auto-hébergement détaille la marche à suivre.