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ébergement | Mise en route | Base de données | Où tournent l’application et la base | Mise à jour en deux clics |
|---|---|---|---|---|
| Vercel avec Neon | Un bouton | Neon, créée par le bouton | Fonctions à Francfort, base Neon dans la région choisie (Frankfurt recommandée) | Oui, automatique |
| Railway | Un projet depuis GitHub, plus une base | Service PostgreSQL de Railway, dans le même projet | Région choisie dans Railway | Oui, quand le déploiement vient d’un commit GitHub |
| Render | Un bouton (Blueprint) | Render Postgres, créée par le Blueprint | Francfort, pour le service comme pour la base | Oui, quand le déploiement vient d’un commit GitHub |
| Fly.io | En ligne de commande | Fly Postgres, Neon ou un autre Postgres | Paris (cdg) pour l’application, la base selon votre choix | Avec un workflow GitHub Actions à ajouter |
| Clever Cloud | Console ou ligne de commande | Module PostgreSQL de Clever Cloud | Hébergeur français, en France | Si l’application est liée à GitHub |
| Coolify, Dokploy | Votre serveur, avec un panneau d’administration | Conteneur Postgres du fichier Compose | Votre serveur, dans le pays de votre choix | Si le déploiement automatique est activé |
| Docker | Votre serveur, en ligne de commande | Conteneur Postgres ou base existante | Votre serveur, dans le pays de votre choix | Non : 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_dumpré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.