Aller au contenu

Choisir son hébergement

Vercel avec Neon, Railway, Render, Fly.io, Clever Cloud, Coolify, Dokploy ou Docker : les façons d’héberger Kledg, leurs différences et le guide à suivre pour chacune.

Kledg ne s’utilise pas comme un service en ligne : vous hébergez votre propre instance, et vos écritures restent dans votre propre base Postgres. Le dépôt de Kledg contient un fichier de configuration pour chaque hébergement décrit ici. Hors Vercel, tous construisent l’image du Dockerfile, qui applique les migrations de la base avant de démarrer l’application.

En résumé

HébergementMise en routeBase de donnéesOù tournent l’application et la baseMise à jour en deux clics
Vercel avec NeonUn boutonNeon, créée par le boutonFonctions à Francfort, base Neon dans la région choisie (Frankfurt recommandée)Oui, automatique
RailwayUn projet depuis GitHub, plus une baseService PostgreSQL de Railway, dans le même projetRégion choisie dans RailwayOui, quand le déploiement vient d’un commit GitHub
RenderUn bouton (Blueprint)Render Postgres, créée par le BlueprintFrancfort, pour le service comme pour la baseOui, quand le déploiement vient d’un commit GitHub
Fly.ioEn ligne de commandeFly Postgres, Neon ou un autre PostgresParis (cdg) pour l’application, la base selon votre choixAvec un workflow GitHub Actions à ajouter
Clever CloudConsole ou ligne de commandeModule PostgreSQL de Clever CloudHébergeur français, en FranceSi l’application est liée à GitHub
Coolify, DokployVotre serveur, avec un panneau d’administrationConteneur Postgres du fichier ComposeVotre serveur, dans le pays de votre choixSi le déploiement automatique est activé
DockerVotre serveur, en ligne de commandeConteneur Postgres ou base existanteVotre serveur, dans le pays de votre choixNon : commandes sur le serveur

Le coût dépend de chaque hébergeur et de l’offre choisie : voir la tarification de l’hébergeur (Vercel et Neon, Railway, Render, Fly.io, Clever Cloud). Avec Coolify, Dokploy ou Docker, vous payez votre serveur.

Partout, la page Mises à jour de Kledg reconnaît l’hébergeur et indique comment installer une nouvelle version : voir Mettre à jour son instance.

Vercel avec Neon

Le chemin le plus court. Le bouton Déployer sur Vercel crée une copie du dépôt dans votre compte GitHub, le projet Vercel et une base Postgres Neon. Il n’y a aucun serveur à administrer, et la synchronisation bancaire quotidienne est une tâche planifiée de Vercel. Vercel redéploie à chaque fusion sur votre dépôt : la mise à jour en deux clics fonctionne sans réglage.

À choisir si vous voulez démarrer en quelques minutes, sans rien administrer. Guide : Installer Kledg.

Railway

L’application et sa base PostgreSQL vivent dans le même projet Railway, sans serveur à administrer. Railway lit le fichier railway.json du dépôt, applique les migrations avant de basculer vers la nouvelle version et redéploie à chaque push sur la branche suivie. Il n’y a pas encore de bouton de déploiement en un clic : le projet se crée en quelques étapes.

À choisir si vous voulez une plateforme gérée avec la base incluse et des mises à jour automatiques depuis GitHub. Guide : Héberger Kledg sur Railway.

Render

Le bouton Deploy to Render lit le fichier render.yaml du dépôt : il crée le service et une base Render Postgres, tous deux à Francfort, génère les secrets et relie la base à l’application. Render redéploie à chaque commit de la branche suivie.

À choisir si vous voulez un déploiement presque aussi simple que Vercel, avec la base incluse et hébergée dans l’Union européenne. Lisez les limites de l’offre gratuite avant d’y mettre votre comptabilité. Guide : Héberger Kledg sur Render.

Fly.io

Tout se fait en ligne de commande avec fly. Le fichier fly.toml place l’application à Paris et arrête la machine quand personne ne s’en sert. Pour la base, Fly Postgres (qui n’est pas une base managée : ses sauvegardes sont à votre charge) ou une base managée comme Neon. Fly.io ne redéploie pas tout seul depuis GitHub : il faut ajouter un workflow GitHub Actions pour les mises à jour en deux clics.

À choisir si vous êtes à l’aise avec la ligne de commande et voulez l’application en France. Guide : Héberger Kledg sur Fly.io.

Clever Cloud

Clever Cloud est une société française qui héberge en France : un critère possible pour des données comptables. Kledg s’y déploie en application Docker, avec le module PostgreSQL de Clever Cloud, sauvegardé chaque jour (sauf l’offre DEV, réservée aux essais).

À choisir si vous voulez un hébergeur français et une base managée. Guide : Héberger Kledg sur Clever Cloud.

Coolify ou Dokploy

Coolify et Dokploy installent un panneau d’administration sur votre propre serveur. Ils utilisent tel quel le fichier docker-compose.yml du dépôt (Kledg, sa base Postgres, les vérifications de santé et les volumes de sauvegarde), et leur proxy gère le domaine et le HTTPS.

À choisir si vous voulez garder la main sur le serveur et le pays où sont vos données, sans tout faire en ligne de commande. Guide : Héberger Kledg avec Docker.

Docker sur votre serveur

Le même fichier docker-compose.yml, lancé avec docker compose sur un serveur virtuel ou une machine interne. Vous gardez la main sur tout ; en contrepartie, le HTTPS, les sauvegardes hors du serveur, les mises à jour du système et la synchronisation bancaire quotidienne sont à votre charge.

À choisir si vous administrez déjà des serveurs. Guide : Héberger Kledg avec Docker.

Points communs

  • Hors Vercel, la synchronisation bancaire quotidienne est un appel HTTP à planifier vous-même : voir La synchronisation bancaire quotidienne.
  • Quel que soit l’hébergeur, planifiez un pg_dump régulier vers un stockage que vous contrôlez, en plus des sauvegardes de l’hébergeur.
  • Le guide de référence, avec tous les détails techniques, est dans le dépôt : docs/self-hosting.md.

Si vous préférez ne pas vous en occuper, l’installation accompagnée est sur devis.

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.