{"id":7488,"date":"2026-08-19T19:10:11","date_gmt":"2026-08-19T19:10:11","guid":{"rendered":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/reference\/configuration\/"},"modified":"2026-11-09T16:26:14","modified_gmt":"2026-11-09T16:26:14","slug":"configuration","status":"publish","type":"wvn_doc","link":"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/reference\/configuration\/","title":{"rendered":"Configuration de l&rsquo;instance"},"content":{"rendered":"<h1>Configuration de l&rsquo;instance<\/h1>\n<p>Une instance serveur se configure en partie au d\u00e9ploiement, par un fichier de configuration et des variables d&rsquo;environnement. C&rsquo;est compl\u00e9mentaire de l&rsquo;interface : la plupart des r\u00e9glages se font dans l&rsquo;application, et la configuration sert au d\u00e9ploiement automatis\u00e9, aux param\u00e8tres structurants et au verrouillage de certains choix.<\/p>\n<p>Cette page d\u00e9crit les cat\u00e9gories de r\u00e9glages et les variables propres \u00e0 Wiven. La r\u00e9f\u00e9rence compl\u00e8te des variables est remise avec l&rsquo;installation.<\/p>\n<hr \/>\n<h2>Mandatory secrets<\/h2>\n<p>Trois secrets doivent \u00eatre longs, al\u00e9atoires et propres \u00e0 votre installation : ils signent les sessions et chiffrent les secrets enregistr\u00e9s par l&rsquo;application. Ne r\u00e9utilisez jamais des valeurs d&rsquo;exemple.<\/p>\n<ul>\n<li>Changing the session secret disconnects all users.<\/li>\n<li>Changer les secrets de signature rend illisibles les secrets d\u00e9j\u00e0 chiffr\u00e9s : connecteurs SSO, jetons de messagerie et d&rsquo;agenda, double authentification.<\/li>\n<\/ul>\n<hr \/>\n<h2>Storage<\/h2>\n<p>Un r\u00e9pertoire unique contient la base de donn\u00e9es, les documents, les index, les mod\u00e8les, le journal d&rsquo;audit et les politiques de s\u00e9curit\u00e9. C&rsquo;est le param\u00e8tre le plus important en exploitation : il doit pointer vers un volume persistant, sauvegard\u00e9 avec le fichier de configuration. Si le stockage n&rsquo;est pas persistant, tout est perdu au red\u00e9marrage.<\/p>\n<hr \/>\n<h2>Network and service<\/h2>\n<ul>\n<li>Les ports d&rsquo;\u00e9coute de l&rsquo;application et du service d&rsquo;extraction de documents sont configurables.<\/li>\n<li>Le TLS peut \u00eatre activ\u00e9 directement dans l&rsquo;application, avec votre certificat et votre cl\u00e9. Si un reverse proxy assure le TLS, laissez le TLS applicatif d\u00e9sactiv\u00e9.<\/li>\n<li>Derri\u00e8re un reverse proxy, indiquez-le \u00e0 l&rsquo;application : sans cela, les limites de d\u00e9bit ne voient pas l&rsquo;adresse r\u00e9elle des visiteurs.<\/li>\n<\/ul>\n<hr \/>\n<h2>Authentication<\/h2>\n<ul>\n<li><strong>unique password<\/strong> en mode mono-utilisateur. En mode multi-utilisateurs, les comptes sont g\u00e9r\u00e9s dans l&rsquo;application et ce mot de passe n&rsquo;a plus d&rsquo;effet.<\/li>\n<li><strong>Session duration<\/strong> : 30 days by default.<\/li>\n<li><strong>Password complexity rules<\/strong> : length, lowercase letters, uppercase letters, numbers, symbols.<\/li>\n<li><strong>Guest sessions<\/strong> : nouvelles sessions par heure, 5 par adresse et 100 pour l&rsquo;instance par d\u00e9faut.<\/li>\n<\/ul>\n<table>\n<thead>\n<tr>\n<th>Variable<\/th>\n<th>Role<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>WIVEN_LICENSE<\/code><\/td>\n<td>The WivenLLM Business license itself, as an alternative to the file installed from the Wiven Console<\/td>\n<\/tr>\n<tr>\n<td><code>WIVEN_MFA_REQUIRED_ROLES<\/code><\/td>\n<td>R\u00f4les pour lesquels la double authentification est obligatoire. L&rsquo;\u00e9cran ne peut plus les changer<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<hr \/>\n<h2>AI Providers<\/h2>\n<p>Chaque fournisseur se configure sur un sch\u00e9ma constant : une cl\u00e9 d&rsquo;API ou une adresse de service, une pr\u00e9f\u00e9rence de mod\u00e8le et, parfois, une limite de contexte lorsqu&rsquo;elle ne peut pas \u00eatre d\u00e9couverte automatiquement. Trois choix d\u00e9signent la s\u00e9lection active : le fournisseur de mod\u00e8le de langage, le moteur d&#8217;embeddings et la base vectorielle.<\/p>\n<p>La configuration du mod\u00e8le de langage est reprise une seule fois en base, au premier d\u00e9marrage : ensuite, c&rsquo;est la valeur enregistr\u00e9e dans l&rsquo;application qui fait foi. Le moteur d&#8217;embeddings et la base vectorielle restent d\u00e9finis par la configuration. R\u00e9glez chaque point \u00e0 un seul endroit.<\/p>\n<hr \/>\n<h2>Security and sovereignty<\/h2>\n<p>When they are filled in, the variables <code>WIVEN_<\/code> ci-dessous verrouillent le r\u00e9glage : l&rsquo;\u00e9cran correspondant de la Console Wiven ne peut plus le changer.<\/p>\n<table>\n<thead>\n<tr>\n<th>Variable<\/th>\n<th>Role<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>WIVEN_EGRESS_MODE<\/code><\/td>\n<td>Sovereign mode: <code>off<\/code>, <code>monitor<\/code> (by default, logs without blocking) or <code>strict<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>WIVEN_PII_SHIELD<\/code><\/td>\n<td>Personal Data Shield: <code>off<\/code> (by default), <code>external<\/code> Or <code>always<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>WIVEN_GROUNDING<\/code><\/td>\n<td>Unsourced claims: <code>off<\/code> (by default), <code>note<\/code> Or <code>verify<\/code><\/td>\n<\/tr>\n<tr>\n<td><code>WIVEN_MODEL_APPROVAL<\/code><\/td>\n<td><code>enforce<\/code> Requires approved templates. Disabled by default<\/td>\n<\/tr>\n<tr>\n<td><code>AUDIT_RETENTION_MONTHS<\/code><\/td>\n<td>Mois de journal d&rsquo;audit \u00e0 conserver. Sans limite si elle n&rsquo;est pas renseign\u00e9e<\/td>\n<\/tr>\n<tr>\n<td><code>AUDIT_SYSLOG_URL<\/code><\/td>\n<td>Envoi du journal d&rsquo;audit vers un SIEM, en UDP ou en TCP<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<hr \/>\n<h2>Options d&rsquo;exploitation<\/h2>\n<p>D&rsquo;autres r\u00e9glages d&rsquo;installation permettent notamment de :<\/p>\n<ul>\n<li>retirer la consultation centrale de l&rsquo;historique des conversations et son export ;<\/li>\n<li>interdire la suppression des espaces de travail, depuis l&rsquo;interface et par l&rsquo;API ;<\/li>\n<li>masquer la documentation d&rsquo;API interactive ;<\/li>\n<li>require a list of authorized domains for any web widget;<\/li>\n<li>autoriser, ou non, l&rsquo;import de pages et la lecture web des agents vers des adresses internes, et restreindre ces lectures \u00e0 une liste d&rsquo;h\u00f4tes ;<\/li>\n<li>fixer le nombre maximal d&rsquo;appels d&rsquo;outils par r\u00e9ponse d&rsquo;agent (10 par d\u00e9faut) et les comp\u00e9tences approuv\u00e9es d&rsquo;avance \u2014 jamais l&rsquo;envoi, la r\u00e9ponse ou la suppression de messages ;<\/li>\n<li>set scheduled tasks: simultaneous executions (1 by default) and maximum duration (5 minutes by default);<\/li>\n<li>choose the languages for character recognition (English by default);<\/li>\n<li>set the resynchronization time for monitored documents (7 days by default);<\/li>\n<li>Enable anonymous telemetry, which is disabled by default.<\/li>\n<\/ul>\n<p>On a sovereignty-required installation, leave telemetry disabled and document it.<\/p>\n<hr \/>\n<h2>Best practices<\/h2>\n<p><strong>Treat the configuration file like a secret.<\/strong> Il contient toutes vos cl\u00e9s. Restreignez ses droits d&rsquo;acc\u00e8s, ne le versionnez pas, sauvegardez-le s\u00e9par\u00e9ment et de mani\u00e8re chiffr\u00e9e.<\/p>\n<p><strong>Generate real secrets.<\/strong> A long random string, produced by a generator, for each of the three required values.<\/p>\n<p><strong>Check storage persistence<\/strong> avant la mise en service : red\u00e9marrez l&rsquo;instance et confirmez que les r\u00e9glages et les documents sont toujours l\u00e0.<\/p>\n<p><strong>Document your choices.<\/strong> Quel fournisseur, quel moteur d&#8217;embeddings, quelle base : ces informations seront n\u00e9cessaires pour votre registre des traitements et pour toute intervention ult\u00e9rieure.<\/p>","protected":false},"parent":7453,"menu_order":703,"template":"","meta":[],"class_list":["post-7488","wvn_doc","type-wvn_doc","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.9 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Variables d&#039;environnement \u2014 Documentation WivenLLM<\/title>\n<meta name=\"description\" content=\"Configurer une instance au d\u00e9ploiement \u2014 secrets obligatoires, r\u00e9seau, fournisseurs et options d&#039;exploitation.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/reference\/configuration\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Variables d&#039;environnement \u2014 Documentation WivenLLM\" \/>\n<meta property=\"og:description\" content=\"Configurer une instance au d\u00e9ploiement \u2014 secrets obligatoires, r\u00e9seau, fournisseurs et options d&#039;exploitation.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/reference\/configuration\/\" \/>\n<meta property=\"og:site_name\" content=\"Wiven AI\" \/>\n<meta property=\"article:modified_time\" content=\"2026-11-09T16:26:14+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/reference\\\/configuration\\\/\",\"url\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/reference\\\/configuration\\\/\",\"name\":\"Variables d'environnement \u2014 Documentation WivenLLM\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/#website\"},\"datePublished\":\"2026-08-19T19:10:11+00:00\",\"dateModified\":\"2026-11-09T16:26:14+00:00\",\"description\":\"Configurer une instance au d\u00e9ploiement \u2014 secrets obligatoires, r\u00e9seau, fournisseurs et options d'exploitation.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/reference\\\/configuration\\\/#breadcrumb\"},\"inLanguage\":\"en\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/reference\\\/configuration\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/reference\\\/configuration\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/www.wiven.ai\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documentation\",\"item\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"R\u00e9f\u00e9rence\",\"item\":\"https:\\\/\\\/www.wiven.ai\\\/wiven-llm\\\/docs\\\/reference\\\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Configuration de l&rsquo;instance\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.wiven.ai\\\/#website\",\"url\":\"https:\\\/\\\/www.wiven.ai\\\/\",\"name\":\"Wiven AI\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.wiven.ai\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Environment Variables \u2014 WivenLLM Documentation","description":"Configuring an instance for deployment \u2014 required secrets, network, providers and operating options.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/reference\/configuration\/","og_locale":"en_US","og_type":"article","og_title":"Variables d'environnement \u2014 Documentation WivenLLM","og_description":"Configurer une instance au d\u00e9ploiement \u2014 secrets obligatoires, r\u00e9seau, fournisseurs et options d'exploitation.","og_url":"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/reference\/configuration\/","og_site_name":"Wiven AI","article_modified_time":"2026-11-09T16:26:14+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/reference\/configuration\/","url":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/reference\/configuration\/","name":"Environment Variables \u2014 WivenLLM Documentation","isPartOf":{"@id":"https:\/\/www.wiven.ai\/#website"},"datePublished":"2026-08-19T19:10:11+00:00","dateModified":"2026-11-09T16:26:14+00:00","description":"Configuring an instance for deployment \u2014 required secrets, network, providers and operating options.","breadcrumb":{"@id":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/reference\/configuration\/#breadcrumb"},"inLanguage":"en","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.wiven.ai\/wiven-llm\/docs\/reference\/configuration\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/reference\/configuration\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.wiven.ai\/"},{"@type":"ListItem","position":2,"name":"Documentation","item":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/"},{"@type":"ListItem","position":3,"name":"R\u00e9f\u00e9rence","item":"https:\/\/www.wiven.ai\/wiven-llm\/docs\/reference\/"},{"@type":"ListItem","position":4,"name":"Configuration de l&rsquo;instance"}]},{"@type":"WebSite","@id":"https:\/\/www.wiven.ai\/#website","url":"https:\/\/www.wiven.ai\/","name":"Wiven AI","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.wiven.ai\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en"}]}},"_links":{"self":[{"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/wvn_doc\/7488","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/wvn_doc"}],"about":[{"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/types\/wvn_doc"}],"up":[{"embeddable":true,"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/wvn_doc\/7453"}],"wp:attachment":[{"href":"https:\/\/www.wiven.ai\/en\/wp-json\/wp\/v2\/media?parent=7488"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}