Organization IA Sources de recette · paquets 0.5.1

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

ModeStockage principalAccèsLimite
Bureau localDisque de son ordinateurNavigateur du même ordinateurPas de synchronisation entre applications indépendantes
Serveur LAN ou VPNDisque et base du serveur communNavigateurs autorisés sur le réseau protégéService permanent, TLS et sauvegardes à administrer
Serveur cloud administréStockage du serveur choisiAdresse HTTPS administréeAucun 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.

VariableEffet réel
ORGIA_DBChemin du fichier SQLite ; défaut source data/organization.db
ORGIA_DATABASE_URLConnexion PostgreSQL ; ne pas publier l’URL contenant ses identifiants
ORGIA_HOSTAdresse d’écoute ; défaut source 127.0.0.1
PORTPort du serveur ; défaut 5173
ORGIA_PRODUCTION=1Empêche la démo et la remise à zéro
ORGIA_ALLOW_SIGNUP=0Ferme la création d’organisations
ORGIA_BASE_URLAdresse externe des liens envoyés aux destinataires
ORGIA_HTTPS=1Déclare le fonctionnement derrière HTTPS et active HSTS ; ne crée pas de certificat
ORGIA_TRUST_PROXY=1Fait confiance à X-Forwarded-For ; seulement derrière un proxy contrôlé
ORGIA_SCHEDULER=0Suspend 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.

Documentation préparée pour publication. Logiciel et accès web en recette privée ; aucun accès public ouvert par ce portail.