Aller au contenu
Kledg

Déployez votre propre instance Kledg

Kledg s’installe chez vous. Le pack de démarrage recommandé combine Vercel, Neon et Resend, avec un déploiement en un clic. Kledg fonctionne aussi partout où tournent Node.js et Postgres.

Déployer sur VercelVoir sur GitHub

Ce dont vous avez besoin

  • Vercel

    Hébergement de l’application Next.js

    Requis
  • Neon

    Base de données Postgres

    Requis
  • Resend

    Envoi des emails

    Requis
  • Vercel AI Gateway

    Fonctions d’IA, avec le fournisseur de modèle de votre choix

    Optionnel

Un compte GitHub est aussi nécessaire : le déploiement crée une copie du dépôt Kledg dans votre compte.

Variables d’environnement

Dans les paramètres du projet Vercel (le bouton de déploiement vous les demande) ou dans l’environnement de votre serveur. Pour générer un secret robuste, une commande suffit :

openssl rand -base64 32
DATABASE_URLConnexion à votre base Postgres. Renseignée automatiquement par l’intégration Neon, avec DATABASE_URL_UNPOOLED pour les migrations.Requis
BETTER_AUTH_SECRETSecret aléatoire qui signe les sessions. Générez-le avec openssl rand -base64 32.Requis
ADMIN_EMAILVotre email : lui seul pourra créer le compte administrateur au premier lancement.Requis
RESEND_API_KEYClé API Resend pour les emails (mot de passe oublié, accès des membres). Sans elle, les emails sont écrits dans les logs.Optionnel
EMAIL_FROMAdresse d’expédition, sur un domaine vérifié dans Resend.Optionnel
CRON_SECRETProtège la synchronisation bancaire quotidienne. Vercel le transmet automatiquement à la tâche planifiée.Optionnel
BETTER_AUTH_URLURL publique de l’instance, à définir avec un domaine personnalisé. Par défaut : l’URL de production Vercel.Optionnel
ENCRYPTION_KEYChiffre les identifiants bancaires en base. Par défaut, une clé est dérivée de BETTER_AUTH_SECRET.Optionnel
AI_GATEWAY_API_KEYClé Vercel AI Gateway, nécessaire hors de Vercel. Sur Vercel, l’IA s’authentifie automatiquement (OIDC) ; KLEDG_AI_DISABLED=true la désactive.Optionnel

Étape par étape

  1. 1

    Lancer le déploiement

    Cliquez sur « Déployer sur Vercel ». Vercel crée un dépôt dans votre compte GitHub à partir du code de Kledg, puis le projet.

  2. 2

    Créer la base Neon

    Acceptez la base Postgres Neon proposée par Vercel, de préférence dans la région Frankfurt : elle est reliée au projet automatiquement.

  3. 3

    Renseigner les variables

    Saisissez BETTER_AUTH_SECRET et ADMIN_EMAIL ; les autres variables peuvent attendre. Le build applique les migrations de la base tout seul.

  4. 4

    Créer le compte administrateur

    Ouvrez l’URL de votre instance : la page de configuration crée le compte administrateur, avec l’email défini dans ADMIN_EMAIL.

  5. 5

    Configurer Resend

    Vérifiez un domaine d’expédition dans Resend, créez une clé API, renseignez RESEND_API_KEY et EMAIL_FROM, puis redéployez.

  6. 6

    Reprendre vos données

    Créez votre société, puis importez votre FEC, vos fichiers CSV ou Excel, ou vos relevés bancaires.

Le README du dépôt fait foi pour le détail propre à chaque version. README

Lire le guide de déploiement pas à pas

Mettre à jour votre instance

Votre instance est déployée depuis votre propre dépôt GitHub. Pour passer à une nouvelle version, récupérez les nouveaux commits du dépôt Kledg dans ce dépôt : Vercel détecte le nouveau commit et redéploie automatiquement.

  • Si vous avez forké Kledg sur GitHub, utilisez le bouton « Sync fork » de votre dépôt.

    Documentation GitHub sur la synchronisation d’un fork

  • Si vous avez utilisé le bouton « Deploy to Vercel », votre dépôt est une copie indépendante, sans lien de fork. Ajoutez le dépôt Kledg comme source amont, une fois pour toutes, puis fusionnez ses changements :

    git remote add upstream https://github.com/kledghq/kledg.git
git pull upstream main
git push

    Pour profiter du bouton « Sync fork », vous pouvez aussi forker le dépôt sur GitHub puis l’importer dans Vercel au lieu d’utiliser le bouton de déploiement.

Avant une mise à jour importante, faites une sauvegarde de votre base (Neon permet de créer une branche ou un instantané) et un export FEC.

Combien ça coûte ?

Kledg lui-même est gratuit. Pour démarrer, les offres gratuites de Vercel, Neon et Resend peuvent suffire pour un petit volume. Leurs conditions et leurs limites évoluent : vérifiez-les avant de vous lancer. L’offre Hobby de Vercel, par exemple, est réservée à un usage personnel et non commercial ; pour une société, l’offre Pro peut être nécessaire.

Ailleurs que sur Vercel

Kledg est une application Node.js qui s’appuie sur Postgres. Elle peut tourner sur votre propre serveur, dans un conteneur ou chez un autre hébergeur. Il vous faudra alors fournir les mêmes variables d’environnement, un service d’envoi d’emails compatible et déclencher vous-même les tâches planifiées.

Produisez vos comptes annuels avec Kledg.

Déployez votre instance sur Vercel avec Neon, ou explorez d’abord le code.

Déployer sur VercelVoir sur GitHub