Installer Kledg

Kledg ne s’utilise pas comme un service en ligne : vous installez votre propre instance. Vos écritures sont stockées dans votre base de données, et personne d’autre n’y a accès. Cette page décrit le chemin le plus simple : Vercel pour l’application, Neon pour la base de données.

Ce qu’il vous faut

• un compte GitHub, qui hébergera votre copie du code ;
• un compte Vercel, qui exécutera l’application ;
• un compte Neon, créé automatiquement depuis Vercel, pour la base PostgreSQL ;
• plus tard, un compte Resend pour l’envoi des emails (mot de passe oublié, accès des collaborateurs).

Comptez une dizaine de minutes.

Déployer

1. Depuis la page Auto-hébergement, cliquez sur Déployer sur Vercel.
2. Vercel crée une copie du dépôt Kledg dans votre compte GitHub, puis vous propose de créer une base Neon. Acceptez et choisissez la région Frankfurt, la plus proche des serveurs de Kledg.
3. Renseignez les deux variables obligatoires :
   • BETTER_AUTH_SECRET : un secret aléatoire, que vous pouvez générer avec openssl rand -base64 32 ;
   • ADMIN_EMAIL : votre adresse email. Elle seule pourra créer le compte administrateur.
4. Lancez le déploiement. Pendant la construction, Kledg crée automatiquement les tables de la base.

Créer le compte administrateur

Ouvrez l’adresse de votre instance (par exemple https://kledg-votre-nom.vercel.app). Vous arrivez sur la page de configuration : choisissez votre nom et votre mot de passe. L’email est celui défini dans ADMIN_EMAIL.

Ce compte administre l’instance : il crée les sociétés et donne accès aux autres utilisateurs.

Et ensuite

• Premiers pas : créer sa société ;
• pour un domaine personnalisé, les emails ou l’hébergement hors Vercel, voir le guide complet Auto-hébergement.