{"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-08-19T19:10:11","modified_gmt":"2026-08-19T19:10:11","slug":"configuration","status":"publish","type":"wvn_doc","link":"https:\/\/www.wiven.ai\/en\/wiven-llm\/docs\/reference\/configuration\/","title":{"rendered":"Environmental variables"},"content":{"rendered":"

Environmental variables<\/h1>\n

The configuration of a server instance is done via environment variables.
\nShe is complementary<\/strong> of the interface: most settings are done
\nin the application, and the variables are used for automated deployment and
\nparameters that must exist before the first startup.<\/p>\n

\n

This page describes the categories and structuring variables. The list
\nexhaustive information is included in the example file provided with the installation.<\/p>\n<\/blockquote>\n

\n

Mandatory<\/h2>\n

These three values must be long, random and unique to your
\nfacility<\/strong>. Never reuse those from the example file: they are
\npublic.<\/p>\n\n\n\n\n\n\n\n
Variable<\/th>\nRole<\/th>\n<\/tr>\n<\/thead>\n
JWT_SECRET<\/code><\/td>\nUser session signing<\/td>\n<\/tr>\n
SIG_KEY<\/code><\/td>\nInternal signature key<\/td>\n<\/tr>\n
SIG_SALT<\/code><\/td>\nSalt associated<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

A change of JWT_SECRET<\/code> invalidates all current sessions: the
\nUsers will need to log in again.<\/p>\n

\n

Storage<\/h2>\n\n\n\n\n\n
Variable<\/th>\nRole<\/th>\n<\/tr>\n<\/thead>\n
STORAGE_DIR<\/code><\/td>\nDirectory containing database, documents, index and models<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

This is the most important variable in operations.<\/strong> It must point towards
\na volume persistent<\/strong>. If the storage is not persistent, everything is lost.
\ncontainer restart.<\/p>\n

\n

Network and service<\/h2>\n\n\n\n\n\n\n\n\n
Variable<\/th>\nRole<\/th>\n<\/tr>\n<\/thead>\n
SERVER_PORT<\/code><\/td>\nApplication listening port<\/td>\n<\/tr>\n
COLLECTOR_PORT<\/code><\/td>\nPort of the document extraction service<\/td>\n<\/tr>\n
ENABLE_HTTPS<\/code><\/td>\nEnables TLS directly within the application<\/td>\n<\/tr>\n
HTTPS_CERT_PATH<\/code>, HTTPS_KEY_PATH<\/code><\/td>\nLocation of the certificate and key<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

If you are using a reverse proxy for TLS, leave application-level TLS enabled.
\ndisabled.<\/p>\n

\n

Authentication<\/h2>\n\n\n\n\n\n\n
Variable<\/th>\nRole<\/th>\n<\/tr>\n<\/thead>\n
AUTH_TOKEN<\/code><\/td>\nUnique password, in single-user mode<\/td>\n<\/tr>\n
JWT_EXPIRY<\/code><\/td>\nValidity period of sessions<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

In multi-user mode, accounts are managed within the application; ;
\nAUTH_TOKEN<\/code> has no effect.<\/p>\n

\n

AI Providers<\/h2>\n

Each supplier has its own variables, following a consistent pattern:<\/p>\n

    \n
  • a API key<\/strong> or a service address<\/strong> ;<\/li>\n
  • a model preference<\/strong> ;<\/li>\n
  • sometimes a context limit<\/strong> when it cannot be discovered
    \n automatically.<\/li>\n<\/ul>\n

    Three general variables define active selection:<\/p>\n\n\n\n\n\n\n\n
    Variable<\/th>\nRole<\/th>\n<\/tr>\n<\/thead>\n
    LLM_PROVIDER<\/code><\/td>\nLanguage model provider<\/td>\n<\/tr>\n
    EMBEDDING_ENGINE<\/code><\/td>\nEmbeddings engine<\/td>\n<\/tr>\n
    VECTOR_DB<\/code><\/td>\nVector base<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n

    These settings can be modified in the interface, and these are the values
    \nrecorded in the application which are considered valid once onboarding is completed.
    \nThe variables are therefore mainly used to preconfigure a deployment.<\/p>\n<\/blockquote>\n

    \n

    Segmentation and indexing<\/h2>\n\n\n\n\n\n\n
    Variable<\/th>\nRole<\/th>\n<\/tr>\n<\/thead>\n
    EMBEDDING_MODEL_MAX_CHUNK_LENGTH<\/code><\/td>\nMaximum size of a fragment sent to the embeddings engine<\/td>\n<\/tr>\n
    MAX_EMBED_CHUNK_SIZE<\/code><\/td>\nFragment size ceiling<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    These values can also be adjusted in the interface.<\/p>\n

    \n

    Agents Verification Status<\/h2>\n\n\n\n\n\n\n\n
    Variable<\/th>\nRole<\/th>\n<\/tr>\n<\/thead>\n
    AGENT_MAX_TOOL_CALLS<\/code><\/td>\nMaximum number of tool calls per task \u2014 safeguard against loops<\/td>\n<\/tr>\n
    Search engine keywords<\/td>\nWeb search skill configuration<\/td>\n<\/tr>\n
    AGENT_AUTO_APPROVED_SKILLS<\/code><\/td>\nSkills that can be performed without confirmation<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n

    Confidentiality and exploitation<\/h2>\n\n\n\n\n\n\n\n
    Variable<\/th>\nRole<\/th>\n<\/tr>\n<\/thead>\n
    DISABLE_TELEMETRY<\/code><\/td>\nCompletely disable telemetry<\/td>\n<\/tr>\n
    DISABLE_SWAGGER_DOCS<\/code><\/td>\nHides the interactive API documentation<\/td>\n<\/tr>\n
    DISABLE_VIEW_CHAT_HISTORY<\/code><\/td>\nPrevents users from viewing their history<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    On a sovereignty-required installation, explicitly disable the
    \nMeasure the telemetry and document it.<\/p>\n

    \n

    Best practices<\/h2>\n

    Treat the configuration file like a secret.<\/strong> It contains all your
    \nKeys. Restrict its access rights, do not version it, back it up.
    \nseparately and in encrypted form.<\/p>\n

    Generate real secrets.<\/strong> A long random string, produced by a
    \ngenerator, for each of the three required values.<\/p>\n

    Check storage persistence<\/strong> Before putting into service: restart
    \nthe instance and confirm that the settings and documents are still there.<\/p>\n

    Document your choices.<\/strong> Which supplier, which embedding engine, which
    \nBase: This information will be necessary for your processing register.
    \nand for any subsequent intervention.<\/p>","protected":false},"parent":7453,"menu_order":703,"template":"","meta":[],"class_list":["post-7488","wvn_doc","type-wvn_doc","status-publish","hentry"],"yoast_head":"\nVariables d'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'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'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'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 name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 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\",\"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\":\"Variables d’environnement\"}]},{\"@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","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 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","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":"Variables d’environnement"}]},{"@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}]}}