Gleba：面向多元化农场的开源农业管理 Web 应用

🌱 Logiciel libre de gestion agricole pour exploitations diversifiées 🌾

Démo • Auto-hébergement • Sauvegarde • Mise à jour • Contribuer

📋 À propos

Gleba est une application web de gestion agricole pour les maraîchers, arboriculteurs, éleveurs, micro-fermes, écolieux et jardins pédagogiques. Elle réunit dans un même outil la planification, le suivi terrain, la cartographie 2D/3D, les stocks, la météo, la traçabilité, la comptabilité, la boutique et l'assistance IA.

🎯 Mission

Rendre les outils de pilotage agricole accessibles aux exploitations diversifiées. Une solution libre, auto-hébergeable et utilisable gratuitement et sans limitation.

✨ Pourquoi Gleba ?

• ✅ 100% Gratuit - Aucun abonnement, aucune limitation
• ✅ Open Source - Code transparent, communauté active
• ✅ Données privées - Auto-hébergeable, vos données vous appartiennent
• ✅ Exploitation diversifiée - Maraîchage, verger, élevage et pilotage économique réunis
• ✅ Référentiels métier - 135+ espèces, 154 ITPs et données agronomiques enrichies

🚀 Fonctionnalités

🥕 Maraîchage

• Planification - Semis, plantations, récoltes prévues et besoins en plants
• Suivi cultural - Cultures, récoltes, interventions, fertilisations et irrigations
• Référentiels - Espèces, variétés, itinéraires techniques, associations et rotations
• Stocks - Semences, plants, fertilisants et récoltes

🗺️ Parcelles et cartographie

• Plan 2D - Planches, arbres et objets aux dimensions réelles sur fond géoréférencé
• Vue 3D - Visualisation du terrain et de la croissance des cultures dans le temps
• Suivi du sol - Parcelles, analyses et historique des interventions
• Météo - Conditions, prévisions, alertes et aide à l'irrigation

🌳 Verger

• Patrimoine arboré - Arbres, lots, zones, variétés et porte-greffes
• Travaux - Opérations, tâches, campagnes de plantation et suivi sanitaire
• Productions - Récoltes fruitières, valorisation et production de bois
• Traçabilité - Observations et traitements intégrés au registre phytosanitaire

🐄 Élevage

• Cheptel multi-espèces - Fiches individuelles, lots, mouvements et pesées
• Santé et reproduction - Soins, prophylaxies, traitements, saillies et naissances
• Productions - Œufs, lait, fromage, alimentation, ventes et abattages
• Registre - Suivi sanitaire, obligations réglementaires et archives vérifiables

📊 Gestion de l'exploitation

• Comptabilité - Clients, fournisseurs, factures, TVA, transactions et export FEC
• Pilotage - Stocks valorisés, coûts de production, marges et tableaux de bord
• Boutique - Catalogue, commandes et vente directe
• Assistant IA - Questions en langage naturel et aide contextualisée selon la configuration

🌾 Base de données enrichie

• 135 espèces - Rendements, besoins NPK, prix marché bio
• 154 ITPs - Calendriers, espacements rangs validés
• 155 variétés - Infos semencières, fournisseurs
• Sources fiables - FranceAgriMer 2026, ITAB, guides bio

🎮 Démo en ligne

Testez Gleba sans installation :

URL : https://gleba.fr/login?demo=1 Compte démo :

• Email: demo@gleba.fr
• Mot de passe: demo2026

🐳 Installation rapide (Docker)

Vous êtes pressé et avez déjà Docker ? Cette section. Sinon, voir Auto-hébergement Debian/Ubuntu plus bas.

# 1. Cloner le projet
git clone https://github.com/GMS64260/gleba.git
cd gleba

# 2. Configurer
cp .env.example .env
# Éditer .env (a minima : NEXTAUTH_SECRET, ADMIN_PASSWORD, et NEXTAUTH_URL
# si vous accédez depuis une autre machine que le serveur)

# 3. Lancer
docker compose up -d

✅ L'application sera sur http://localhost:3000

Comptes créés automatiquement :

• Admin : email admin@gleba.local, mot de passe $ADMIN_PASSWORD (défaut : changeme — à changer dans .env avant le premier lancement)
• Démo : demo@gleba.fr / demo2026

Les deux comptes bootstrap sont immédiatement utilisables, même sans serveur SMTP : leur adresse est marquée vérifiée par les seeds. La vérification par email reste obligatoire pour les comptes inscrits ensuite via l'application.

Référentiel agronomique chargé automatiquement :

• 135 espèces enrichies (rendements, besoins NPK, prix circuit court bio)
• 154 ITPs (itinéraires techniques) avec espacements validés
• Sources : FranceAgriMer 2026, ITAB, guides bio

Le chargement du référentiel est idempotent : il ne s'exécute qu'à la première installation et ne ré-écrase pas vos personnalisations lors des mises à jour.

🖥️ Auto-hébergement Debian/Ubuntu

Installation complète sur une VM Debian 12 (ou Ubuntu 22.04+) fraîche, avec HTTPS via Caddy.

1. Prérequis système

# Outils de base
sudo apt update && sudo apt install -y curl git ca-certificates gnupg

# Docker Engine + plugin Compose (procédure officielle)
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg \
  | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
  https://download.docker.com/linux/debian $(. /etc/os-release && echo "$VERSION_CODENAME") stable" \
  | sudo tee /etc/apt/sources.list.d/docker.list >/dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

# Vérifier
docker --version
docker compose version

Pour Ubuntu, remplacez linux/debian par linux/ubuntu dans les deux URLs ci-dessus.

2. Cloner et configurer Gleba

sudo mkdir -p /var/www && cd /var/www
sudo git clone https://github.com/GMS64260/gleba.git
cd gleba
sudo cp .env.example .env
sudo nano .env

Variables à modifier impérativement dans .env :

3. Premier démarrage

sudo docker compose up -d
sudo docker compose logs -f app
# Attendre "Ready in X ms" puis Ctrl-C

L'app écoute sur http://localhost:3000 (sur le serveur lui-même). Pour exposer en HTTPS sur Internet, passez à l'étape 4.

4. Reverse proxy HTTPS avec Caddy (recommandé)

Caddy gère automatiquement les certificats Let's Encrypt.

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' \
  | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' \
  | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update && sudo apt install -y caddy

Éditer /etc/caddy/Caddyfile :

gleba.example.com {
    reverse_proxy localhost:3000
    encode gzip
}

sudo systemctl reload caddy

Adaptez gleba.example.com à votre nom de domaine (DNS A/AAAA pointant vers la VM, ports 80 et 443 ouverts). Pensez à mettre la même valeur dans NEXTAUTH_URL du .env, puis sudo docker compose up -d pour appliquer.

5. Pare-feu (UFW)

sudo ufw allow ssh
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

Le port 3000 ne doit pas être ouvert publiquement — Caddy lui parle en local.

💾 Sauvegarde et restauration

Toutes les données utilisateur (cultures, récoltes, élevage, compta…) vivent dans le volume Docker postgres_data. Sans backup, un crash de VM = perte définitive.

Sauvegarde manuelle

cd /var/www/gleba
./scripts/backup.sh
# → dump créé dans /var/backups/gleba/gleba-YYYYMMDD-HHMMSS.dump

Variables disponibles :

Cron quotidien (recommandé)

sudo crontab -e

Ajouter :

0 3 * * * cd /var/www/gleba && ./scripts/backup.sh >> /var/log/gleba-backup.log 2>&1

→ backup chaque nuit à 3h, log dans /var/log/gleba-backup.log.

Restauration

cd /var/www/gleba
./scripts/restore.sh /var/backups/gleba/gleba-20260524-030000.dump
# Demande confirmation. Arrête le container app, restore, redémarre.

Avant un upgrade majeur, faire un backup. C'est la procédure de rollback la plus fiable si quelque chose se passe mal.

🔄 Mise à jour

cd /var/www/gleba

# 1. Sauvegarder (toujours, avant toute mise à jour)
./scripts/backup.sh

# 2. Récupérer les nouveautés
sudo git pull

# 3. Purger le cache Next.js (sinon l'ancien build est servi)
sudo rm -rf .next

# 4. Rebuild + restart
sudo docker compose up -d --build app

Les migrations Prisma sont appliquées automatiquement au démarrage via prisma migrate deploy, y compris sur une base PostGIS vide. Il ne faut pas remplacer cette commande par prisma db push : la chaîne versionnée contient aussi des contraintes, des rattrapages historiques et des données de référence.

⚠️ Si vous avez personnalisé le référentiel agronomique (espèces, ITPs, variétés) directement en base, relisez les logs de démarrage après l'update : un éventuel script de migration de référentiel pourrait écraser ces valeurs. Le comportement est idempotent dans le cas standard.

📖 Guide rapide

Premier lancement

1. Connexion avec compte démo ou admin
2. Importer données démo (optionnel) - Fichier gleba_demo_data.json
   • 24 planches sur 3 îlots
   • 76 cultures sur 2024-2026
   • 62 récoltes historiques
3. Explorer le dashboard
4. Utiliser l'assistant 🪄 pour créer votre première culture

Navigation

• Dashboard - Vue d'ensemble, graphiques, calendrier
• Cultures - Liste, filtres, irrigation
• Planification - Cultures/récoltes prévues, semences, plants
• Récoltes - Suivi production, valorisation €
• Plan jardin - Vue 2D, positionnement
• Stocks - Semences, plants, fertilisants

🤖 Serveur MCP - Pilotez Gleba depuis l'IA

Gleba intègre un serveur MCP (Model Context Protocol) avec 39 outils permettant de piloter votre ferme depuis Claude Desktop, Claude Code, ChatGPT ou tout client MCP compatible.

npx -y gleba-mcp-server

Exemples de commandes en langage naturel :

• « Qu'est-ce que je dois faire sur l'exploitation cette semaine ? »
• « Enregistre 3kg de tomates récoltées sur la planche S4 »
• « Combien d'oeufs mes poules ont pondu ce mois-ci ? »
• « Quel est mon chiffre d'affaires ce mois-ci ? »

Le code du serveur MCP est distribué séparément. Voir le package npm gleba-mcp-server pour la documentation complète.

🛠️ Stack technique

📝 Licence et Copyright

Copyright © 2024-2026 GMS64260 (Gleba Project)

Ce logiciel est distribué sous licence AGPL-3.0.

En résumé :

• ✅ Usage gratuit (personnel ou commercial)
• ✅ Modification et distribution autorisées
• ⚠️ Obligation de partager les modifications (même en SaaS)
• ⚠️ Attribution requise : "Powered by Gleba" visible dans l'interface
• ⚠️ Même licence AGPL-3.0 pour versions dérivées

Voir LICENSE et COPYRIGHT.md pour tous les détails.

🙏 Remerciements

• ITAB - Guides techniques maraîchage bio
• FranceAgriMer - Données prix marché 2026
• shadcn/ui - Composants React élégants
• Communauté open source - Next.js, Prisma, et tous les contributeurs

📞 Contact & Communauté

• Issues : GitHub Issues
• Discussions : GitHub Discussions

📜 Origine du nom

Gleba vient du latin glēba : « motte de terre », « sol cultivé ».

Ce terme évoque la connexion ancestrale entre l'homme et la terre qu'il cultive, le sol nourricier source d'abondance.

« Celui qui cultive sa glèbe avec soin récoltera l'abondance. »

Fait avec 🌱 pour celles et ceux qui font vivre la terre

⬆ Retour en haut