Guides · Édition du 14 novembre 2026
Local, réseau privé et cloud
Choisir qui héberge l’instance détermine où les données sont enregistrées et qui peut joindre le serveur. Le navigateur affiche l’interface ; le serveur stocke les données et contacte les services configurés.
Trois modes
| Mode | Stockage principal | Accès | Limite |
|---|---|---|---|
| Bureau local | Disque de son ordinateur | Navigateur du même ordinateur | Pas de synchronisation entre applications indépendantes |
| Serveur LAN ou VPN | Disque et base du serveur commun | Navigateurs autorisés sur le réseau protégé | Service permanent, TLS et sauvegardes à administrer |
| Serveur cloud administré | Stockage du serveur choisi | Adresse HTTPS administrée | Aucun service cloud public ouvert par cette préparation |
Ne jamais placer une base SQLite active dans un partage réseau ou une synchronisation de fichiers pour la faire ouvrir par plusieurs programmes. Une équipe utilise un serveur unique. PostgreSQL est pris en charge via ORGIA_DATABASE_URL ; sa sauvegarde exige les outils PostgreSQL et une sauvegarde séparée des pièces.
Référence de configuration serveur
Les noms suivants sont des variables du processus serveur, pas des réglages de navigateur. Conserver les secrets dans un fichier d’environnement protégé ou un gestionnaire de secrets ; ne pas publier leur valeur.
| Variable | Effet réel |
|---|---|
| ORGIA_DB | Chemin du fichier SQLite ; défaut source data/organization.db |
| ORGIA_DATABASE_URL | Connexion PostgreSQL ; ne pas publier l’URL contenant ses identifiants |
| ORGIA_HOST | Adresse d’écoute ; défaut source 127.0.0.1 |
| PORT | Port du serveur ; défaut 5173 |
| ORGIA_PRODUCTION=1 | Empêche la démo et la remise à zéro |
| ORGIA_ALLOW_SIGNUP=0 | Ferme la création d’organisations |
| ORGIA_BASE_URL | Adresse externe des liens envoyés aux destinataires |
| ORGIA_HTTPS=1 | Déclare le fonctionnement derrière HTTPS et active HSTS ; ne crée pas de certificat |
| ORGIA_TRUST_PROXY=1 | Fait confiance à X-Forwarded-For ; seulement derrière un proxy contrôlé |
| ORGIA_SCHEDULER=0 | Suspend le scheduler et les webhooks automatiques pour une recette isolée |
Préparer une instance sans l’exposer
Exemple source pour un opérateur : base neuve dans un dossier protégé existant, écoute locale seulement. L’inscription reste fermée : organiser le compte administrateur via une procédure de préparation privée, sans ouvrir des inscriptions publiques pour dépanner.
ORGIA_PRODUCTION=1 ORGIA_ALLOW_SIGNUP=0 ORGIA_HOST=127.0.0.1 PORT=5173 python3 server.py
Un tunnel SSH peut donner un accès privé à cette écoute. Il ne transforme pas localhost en URL partageable. Le lanceur desktop.py ne remplace pas un gestionnaire de service : prévoir démarrage, reprise après incident et surveillance du serveur.
Docker et PostgreSQL
Le dépôt contient Dockerfile, docker-compose.yml et Caddyfile. Le scénario Docker/PostgreSQL a été exécuté en recette isolée. Le fichier Compose de déploiement ouvre les ports 80/443 et gère un domaine : ne pas le lancer sur une infrastructure existante sans décision d’exploitation et vérification des conflits.
Le service de sauvegarde Compose exporte PostgreSQL ; il ne sauvegarde pas le volume des pièces jointes. Coordonner base, fichiers, secrets de service et procédure de reprise. Les essais ne valent ni exploitation publique validée ni sauvegarde client complète.