Auto-héberger Keeplas

Prérequis

Il vous faut une chaîne d'outils Node récente, pnpm et un déploiement Convex. Docker est optionnel pour un environnement de dev conteneurisé.

• check_circleNode.js 20+ et pnpm 10+ (corepack enable recommandé)
• check_circleUn déploiement Convex -- Convex Cloud ou auto-hébergé (CONVEX_MODE=selfhosted)
• check_circleDocker (optionnel) pour un environnement de dev conteneurisé et figé

Amorçage en une commande

Clonez le dépôt, puis lancez l'amorçage. Il copie votre .env.local, installe les dépendances et lie les fichiers env par package.

$ git clone https://github.com/Keeplas/keeplas.git
$ cd keeplas
$ pnpm bootstrap

Provisionner Convex & les secrets

Générez le secret HMAC d'audit, provisionnez votre déploiement Convex, initialisez les clés d'authentification, poussez votre env, puis démarrez l'application.

$ openssl rand -base64 32   # définit KEEPLAS_CTX_SECRET dans .env.local
$ npx convex dev --once --configure=new
$ npx @convex-dev/auth          # initialise les clés JWT
$ pnpm sync:convex-env
$ pnpm dev

Ou utilisez Docker

Vous préférez les conteneurs ? Le fichier Dockerfile.dev fourni fige Node et pnpm pour correspondre à la CI, avec les sources montées en bind pour le rechargement à chaud.

$ cp .env.local.example .env.local   # puis renseignez KEEPLAS_CTX_SECRET
$ docker compose up

Déployer en production

Le déploiement de référence cible Vercel pour l'application web et Convex Cloud pour le backend. Comme le Vault est zero-knowledge, votre serveur ne détient jamais que du texte chiffré -- l'auto-hébergement change qui exploite les serveurs, pas qui peut lire vos données. Vous seul le pouvez.