mirror of
https://github.com/langflow-ai/langflow.git
synced 2026-07-24 06:10:49 +08:00
177 lines
80 KiB
HTML
177 lines
80 KiB
HTML
<!doctype html>
|
||
<html lang="en" dir="ltr" class="docs-wrapper plugin-docs plugin-id-default docs-version-1.9.0 docs-doc-page docs-doc-id-Develop/environment-variables" data-has-hydrated="false">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="generator" content="Docusaurus v3.9.2">
|
||
<title data-rh="true">Environment variables | Langflow Documentation</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.langflow.org/environment-variables"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="1.9.0"><meta data-rh="true" name="docusaurus_tag" content="docs-default-1.9.0"><meta data-rh="true" name="docsearch:version" content="1.9.0"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-1.9.0"><meta data-rh="true" property="og:title" content="Environment variables | Langflow Documentation"><meta data-rh="true" name="description" content="In general, environment variables, like LANGFLOWPORT or LANGFLOWLOG_LEVEL, configure how Langflow runs."><meta data-rh="true" property="og:description" content="In general, environment variables, like LANGFLOWPORT or LANGFLOWLOG_LEVEL, configure how Langflow runs."><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.langflow.org/environment-variables"><link data-rh="true" rel="alternate" href="https://docs.langflow.org/environment-variables" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.langflow.org/environment-variables" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://UZK6BDPCVY-dsn.algolia.net" crossorigin="anonymous"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Environment variables","item":"https://docs.langflow.org/environment-variables"}]}</script><link rel="preconnect" href="https://www.google-analytics.com">
|
||
<link rel="preconnect" href="https://www.googletagmanager.com">
|
||
<script async src="https://www.googletagmanager.com/gtag/js?id=G-SLQFLQ3KPT"></script>
|
||
<script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("js",new Date),gtag("config","G-SLQFLQ3KPT",{})</script>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<link rel="search" type="application/opensearchdescription+xml" title="Langflow Documentation" href="/opensearch.xml">
|
||
|
||
|
||
|
||
|
||
<script>window._ibmAnalytics={settings:{name:"DataStax",tealiumProfileName:"ibm-subsidiary"},trustarc:{privacyPolicyLink:"https://ibm.com/privacy"},"digitalData.page.services.google.enabled":!0},window.digitalData={page:{pageInfo:{ibm:{siteId:"IBM_"+_ibmAnalytics.settings.name},segment:{enabled:!0,env:"prod",key:"B04fNhD06DqDPuaRfQl5lZ2iQICdxxuh",coremetrics:!1,carbonComponentEvents:!1}},category:{primaryCategory:"PC230"}},commonProperties:{productTitle:"IBM Elite Support for Langflow",productCode:"5900BUB",productCodeType:"WWPC",UT30:"30AS5",instanceId:"docs-site",subscriptionId:"public-access",productPlanName:"Public",productPlanType:"freemium",userId:"IBMid-ANONYMOUS"}}</script>
|
||
<script src="//1.www.s81c.com/common/stats/ibm-common.js" async="true"></script>
|
||
|
||
|
||
<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Geist:wght@300;400;500;600;700&family=Geist+Mono:wght@400;500&family=Sora:wght@550;600&display=swap">
|
||
<script>function gtag(){dataLayer.push(arguments)}window.dataLayer=window.dataLayer||[],gtag("consent","default",{ad_storage:"denied",ad_user_data:"denied",ad_personalization:"denied",analytics_storage:"denied"})</script>
|
||
<script>!function(){function e(){if(void 0!==window.truste&&window.truste.cma){var e=window.truste.cma.callApi("getConsent",window.location.href)||{},n=1===e[2],t=1===e[3];gtag("consent","update",{ad_storage:n?"granted":"denied",ad_user_data:n?"granted":"denied",ad_personalization:n?"granted":"denied",analytics_storage:t?"granted":"denied"})}}window.addEventListener&&(window.addEventListener("cm_data_subject_consent_changed",e),window.addEventListener("cm_consent_preferences_set",e)),"complete"===document.readyState?e():window.addEventListener("load",e)}()</script><link rel="stylesheet" href="/assets/css/styles.d29a2eb4.css">
|
||
<script src="/assets/js/runtime~main.81376a44.js" defer="defer"></script>
|
||
<script src="/assets/js/main.18ca0898.js" defer="defer"></script>
|
||
</head>
|
||
<body class="navigation-with-keyboard">
|
||
<svg style="display: none;"><defs>
|
||
<symbol id="theme-svg-external-link" viewBox="0 0 24 24"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"/></symbol>
|
||
</defs></svg>
|
||
<script>!function(){var t=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return window.localStorage.getItem("theme")}catch(t){}}();document.documentElement.setAttribute("data-theme",t||(window.matchMedia("(prefers-color-scheme: dark)").matches?"dark":"light")),document.documentElement.setAttribute("data-theme-choice",t||"system")}(),function(){try{const c=new URLSearchParams(window.location.search).entries();for(var[t,e]of c)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script><div id="__docusaurus"><div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="theme-layout-navbar navbar navbar--fixed-top"><div class="navbar__inner"><div class="theme-layout-navbar-left navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="/img/lf-docs-light.svg" alt="Langflow" class="themedComponent_mlkZ themedComponent--light_NVdE"><img src="/img/lf-docs-dark.svg" alt="Langflow" class="themedComponent_mlkZ themedComponent--dark_xIcU"></div></a><div class="navbar__item dropdown dropdown--hoverable"><a aria-current="page" class="navbar__link active" aria-haspopup="true" aria-expanded="false" role="button" href="/environment-variables">1.9.x</a><ul class="dropdown__menu"><li><a class="dropdown__link" href="/next/environment-variables">1.10.x (Next)</a></li><li><a aria-current="page" class="dropdown__link dropdown__link--active" href="/environment-variables">1.9.x</a></li><li><a class="dropdown__link" href="/1.8.0/environment-variables">1.8.x</a></li></ul></div></div><div class="theme-layout-navbar-right navbar__items navbar__items--right"><a href="https://github.com/langflow-ai/langflow" target="_blank" class="navbar__item navbar__link header-github-link" aria-label="GitHub" data-event="UI Interaction" data-action="clicked" data-channel="docs" data-element-id="social-github" data-namespace="header" data-platform-title="Langflow"></a><a href="https://twitter.com/langflow_ai" target="_blank" class="navbar__item navbar__link header-twitter-link" aria-label="Twitter" data-event="UI Interaction" data-action="clicked" data-channel="docs" data-element-id="social-twitter" data-namespace="header" data-platform-title="Langflow"></a><a href="https://discord.gg/EqksyE2EX9" target="_blank" class="navbar__item navbar__link header-discord-link" aria-label="Discord" data-event="UI Interaction" data-action="clicked" data-channel="docs" data-element-id="social-discord" data-namespace="header" data-platform-title="Langflow"></a><div class="toggle_MW0i colorModeToggle_DEke"><button class="clean-btn toggleButton_yw5v toggleButtonDisabled_BJd7" type="button" disabled="" title="system mode" aria-label="Switch between dark and light mode (currently system mode)"><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" focusable="false" role="presentation" class="toggleIcon_oIOL lightToggleIcon_SFTY"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" focusable="false" role="presentation" class="toggleIcon_oIOL darkToggleIcon_ekgs"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" aria-hidden="true" focusable="false" role="presentation" class="toggleIcon_oIOL systemToggleIcon_yi_a"><path fill="currentColor" d="m12 21c4.971 0 9-4.029 9-9s-4.029-9-9-9-9 4.029-9 9 4.029 9 9 9zm4.95-13.95c1.313 1.313 2.05 3.093 2.05 4.95s-0.738 3.637-2.05 4.95c-1.313 1.313-3.093 2.05-4.95 2.05v-14c1.857 0 3.637 0.737 4.95 2.05z"></path></svg></button></div><div class="navbarSearchContainer_Bca1"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search (Meta+k)" aria-keyshortcuts="Meta+k"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 24 24" aria-hidden="true"><circle cx="11" cy="11" r="8" stroke="currentColor" fill="none" stroke-width="1.4"></circle><path d="m21 21-4.3-4.3" stroke="currentColor" fill="none" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"></span></button></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="theme-layout-main main-wrapper mainWrapper_z2l0"><div class="docsWrapper_hBAB"><button aria-label="Scroll back to top" class="clean-btn theme-back-to-top-button backToTopButton_sjWU" type="button"></button><div class="docRoot_UBD9"><aside aria-label="Documentation sidebar" class="theme-doc-sidebar-container docSidebarContainer_RSuS"><div class="sidebarViewport_pYEE"><div class="sidebar_njMd"><nav aria-label="Docs sidebar" class="menu thin-scrollbar menu_SIkG"><ul class="theme-doc-sidebar-menu menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 sidebar-group-divider"><div class="sidebar-group-label">Build</div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-rocket"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/"><span title="Get started" class="categoryLinkLabel_W154">Get started</span></a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-workflow"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/concepts-overview"><span title="Flows" class="categoryLinkLabel_W154">Flows</span></a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-bot"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/agents"><span title="Agents" class="categoryLinkLabel_W154">Agents</span></a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-plug"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/mcp-client"><span title="Model Context Protocol (MCP)" class="categoryLinkLabel_W154">Model Context Protocol (MCP)</span></a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 sidebar-group-divider"><div class="sidebar-group-label">Develop & Deploy</div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item sidebar-category-with-icon sidebar-icon-code"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret menu__link--active" role="button" aria-expanded="true" href="/api-keys-and-authentication"><span title="Develop" class="categoryLinkLabel_W154">Develop</span></a></div><ul class="menu__list"><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/api-keys-and-authentication"><span title="API keys and authentication" class="linkLabel_WmDU">API keys and authentication</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/jwt-authentication"><span title="JWT authentication" class="linkLabel_WmDU">JWT authentication</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/install-custom-dependencies"><span title="Install custom dependencies" class="linkLabel_WmDU">Install custom dependencies</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/configuration-global-variables"><span title="Global variables" class="linkLabel_WmDU">Global variables</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link menu__link--active" aria-current="page" tabindex="0" href="/environment-variables"><span title="Environment variables" class="linkLabel_WmDU">Environment variables</span></a></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" tabindex="0" href="/concepts-file-management"><span title="Storage and memory" class="categoryLinkLabel_W154">Storage and memory</span></a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-2 menu__list-item menu__list-item--collapsed"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" tabindex="0" href="/logging"><span title="Observability" class="categoryLinkLabel_W154">Observability</span></a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/data-types"><span title="Use Langflow data types" class="linkLabel_WmDU">Use Langflow data types</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/concepts-voice-mode"><span title="Use voice mode" class="linkLabel_WmDU">Use voice mode</span></a></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-2 menu__list-item"><a class="menu__link" tabindex="0" href="/configuration-cli"><span title="Use the Langflow CLI" class="linkLabel_WmDU">Use the Langflow CLI</span></a></li></ul></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-cloud"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/deployment-overview"><span title="Deploy" class="categoryLinkLabel_W154">Deploy</span></a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 sidebar-group-divider"><div class="sidebar-group-label">Reference</div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-blocks"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/concepts-components"><span title="Components reference" class="categoryLinkLabel_W154">Components reference</span></a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-fileCode"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/api-reference-api-examples"><span title="API reference" class="categoryLinkLabel_W154">API reference</span></a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 sidebar-group-divider"><div class="sidebar-group-label">Community</div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-gitPR"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/contributing-community"><span title="Contribute" class="categoryLinkLabel_W154">Contribute</span></a></div></li><li class="theme-doc-sidebar-item-category theme-doc-sidebar-item-category-level-1 menu__list-item menu__list-item--collapsed sidebar-category-with-icon sidebar-icon-helpCircle"><div class="menu__list-item-collapsible"><a class="categoryLink_byQd menu__link menu__link--sublist menu__link--sublist-caret" role="button" aria-expanded="false" href="/troubleshoot"><span title="Support" class="categoryLinkLabel_W154">Support</span></a></div></li><li class="theme-doc-sidebar-item-link theme-doc-sidebar-item-link-level-1 sidebar-ad">
|
||
<a href="https://www.langflow.org/desktop" target="_blank" rel="noopener noreferrer" class="menu__link">
|
||
<svg width="18" height="18" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg" aria-hidden="true">
|
||
<g clip-path="url(#clip0_1645_37)">
|
||
<path d="M12 17H20C21.1046 17 22 16.1046 22 15V13M12 17H4C2.89543 17 2 16.1046 2 15V5C2 3.89543 2.89543 3 4 3H10M12 17V21M8 21H12M12 21H16M11.75 10.2917H13.2083L16.125 7.375H17.5833L20.5 4.45833H21.9583M16.125 11.75H17.5833L20.5 8.83333H21.9583M11.75 5.91667H13.2083L16.125 3H17.5833" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"/>
|
||
</g>
|
||
<defs>
|
||
<clipPath id="clip0_1645_37">
|
||
<rect width="24" height="24" fill="white"/>
|
||
</clipPath>
|
||
</defs>
|
||
</svg>
|
||
<div class="sidebar-ad-text-container">
|
||
<span class="sidebar-ad-text">Get started in minutes</span>
|
||
<span class="sidebar-ad-text sidebar-ad-text-gradient">Download Langflow Desktop</span>
|
||
</div>
|
||
</a>
|
||
</li></ul></nav></div></div></aside><main class="docMainContainer_TBSr"><div class="container padding-top--md padding-bottom--lg"><div class="row"><div class="col docItemCol_z5aJ"><div class="docItemContainer_c0TR"><article><nav class="theme-doc-breadcrumbs breadcrumbsContainer_Z_bl" aria-label="Breadcrumbs"><ul class="breadcrumbs"><li class="breadcrumbs__item"><a aria-label="Home page" class="breadcrumbs__link" href="/"><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false" role="presentation" class="breadcrumbHomeIcon_xK9p"><path d="M10 19v-5h4v5c0 .55.45 1 1 1h3c.55 0 1-.45 1-1v-7h1.7c.46 0 .68-.57.33-.87L12.67 3.6c-.38-.34-.96-.34-1.34 0l-8.36 7.53c-.34.3-.13.87.33.87H5v7c0 .55.45 1 1 1h3c.55 0 1-.45 1-1z" fill="currentColor"></path></svg></a></li><li class="breadcrumbs__item"><span class="breadcrumbs__link">Develop</span></li><li class="breadcrumbs__item breadcrumbs__item--active"><span class="breadcrumbs__link">Environment variables</span></li></ul></nav><div class="docMetaRow_c2hx"><div class="root_Eutc"><button type="button" class="button_gpNY"><span aria-hidden="true" class="icon_Bm9L"><svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-copy"><rect width="14" height="14" x="8" y="8" rx="2" ry="2"></rect><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"></path></svg></span><span class="label_LzDG">Copy page</span></button></div><span class="theme-doc-version-badge badge badge--secondary">Version: 1.9.x</span></div><div class="tocCollapsible_ETCw theme-doc-toc-mobile tocMobile_ITEo"><button type="button" class="clean-btn tocCollapsibleButton_TO0P">On this page</button></div><div class="theme-doc-markdown markdown"><header><h1>Environment variables</h1></header><style>[data-ch-theme="github-dark"] { --ch-t-colorScheme: dark;--ch-t-foreground: #c9d1d9;--ch-t-background: #0d1117;--ch-t-lighter-inlineBackground: #0d1117e6;--ch-t-editor-background: #0d1117;--ch-t-editor-foreground: #c9d1d9;--ch-t-editor-lineHighlightBackground: #6e76811a;--ch-t-editor-rangeHighlightBackground: #ffffff0b;--ch-t-editor-infoForeground: #3794FF;--ch-t-editor-selectionBackground: #264F78;--ch-t-focusBorder: #1f6feb;--ch-t-tab-activeBackground: #0d1117;--ch-t-tab-activeForeground: #c9d1d9;--ch-t-tab-inactiveBackground: #010409;--ch-t-tab-inactiveForeground: #8b949e;--ch-t-tab-border: #30363d;--ch-t-tab-activeBorder: #0d1117;--ch-t-editorGroup-border: #30363d;--ch-t-editorGroupHeader-tabsBackground: #010409;--ch-t-editorLineNumber-foreground: #6e7681;--ch-t-input-background: #0d1117;--ch-t-input-foreground: #c9d1d9;--ch-t-input-border: #30363d;--ch-t-icon-foreground: #8b949e;--ch-t-sideBar-background: #010409;--ch-t-sideBar-foreground: #c9d1d9;--ch-t-sideBar-border: #30363d;--ch-t-list-activeSelectionBackground: #6e768166;--ch-t-list-activeSelectionForeground: #c9d1d9;--ch-t-list-hoverBackground: #6e76811a;--ch-t-list-hoverForeground: #c9d1d9; }</style>
|
||
<!-- -->
|
||
<p>In general, environment variables, like <code>LANGFLOW_PORT</code> or <code>LANGFLOW_LOG_LEVEL</code>, configure how Langflow runs.
|
||
These are broad settings that apply to your entire Langflow deployment.</p>
|
||
<p>In contrast, global variables are user-defined values stored in Langflow's database for use in flows, such as <code>OPENAI_API_KEY</code>.
|
||
Langflow can also source global variables from environment variables.
|
||
For more information, see <a class="" href="/configuration-global-variables">Langflow global variables</a>.</p>
|
||
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="configure-environment-variables-for-langflow-oss">Configure environment variables for Langflow OSS<a href="#configure-environment-variables-for-langflow-oss" class="hash-link" aria-label="Direct link to Configure environment variables for Langflow OSS" title="Direct link to Configure environment variables for Langflow OSS" translate="no"></a></h2>
|
||
<p>Langflow recognizes <a href="#supported-variables" class="">supported environment variables</a> from the following sources:</p>
|
||
<ul>
|
||
<li class="">Environment variables set in your terminal.</li>
|
||
<li class="">Environment variables imported from a <code>.env</code> file when starting Langflow.</li>
|
||
<li class="">Environment variables set with the <a class="" href="/configuration-cli">Langflow CLI</a>, including the <code>--env-file</code> option and direct options, such as <code>--port</code>.</li>
|
||
</ul>
|
||
<p>You can choose to use one or more of these sources.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="precedence">Precedence<a href="#precedence" class="hash-link" aria-label="Direct link to Precedence" title="Direct link to Precedence" translate="no"></a></h3>
|
||
<p>If the same environment variable is set in multiple places, the following hierarchy applies:</p>
|
||
<ol>
|
||
<li class="">Langflow CLI options override all other sources.</li>
|
||
<li class="">The <code>.env</code> file overrides system environment variables.</li>
|
||
<li class="">System environment variables are used only if not set elsewhere.
|
||
When running a Langflow Docker image, the <code>-e</code> flag can be used to set additional system environment variables.</li>
|
||
</ol>
|
||
<p>For example:</p>
|
||
<ul>
|
||
<li class="">If you set <code>LANGFLOW_PORT=8080</code> in your system environment and <code>LANGFLOW_PORT=7860</code> in <code>.env</code>, Langflow uses <code>7860</code> from <code>.env</code>.</li>
|
||
<li class="">If you use the Langflow CLI to run <code>langflow run --env-file .env --port 9000</code>, and you set <code>LANGFLOW_PORT=7860</code> in <code>.env</code>, then Langflow uses <code>9000</code> from the CLI option.</li>
|
||
</ul>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="configure-variables-terminal">Set environment variables in your terminal<a href="#configure-variables-terminal" class="hash-link" aria-label="Direct link to Set environment variables in your terminal" title="Direct link to Set environment variables in your terminal" translate="no"></a></h3>
|
||
<p>Run the following commands to set environment variables for your current terminal session:</p>
|
||
<div class="theme-tabs-container tabs-container tabList__CuJ"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_LNqP tabs__item--active">Linux or macOS</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Windows</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Docker</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6"><div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>export VARIABLE_NAME='VALUE'</span></div></div><br></code></div></div></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>set VARIABLE_NAME='VALUE'</span></div></div><br></code></div></div></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>docker run -it --rm \</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span> -p 7860:7860 \</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span> -e VARIABLE_NAME='VALUE' \</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span> langflowai/langflow:latest</span></div></div><br></code></div></div></div></div></div>
|
||
<p>When you start Langflow, it looks for environment variables that you've set in your terminal.
|
||
If it detects a supported environment variable, then it automatically adopts the specified value, subject to <a href="#precedence" class="">precedence rules</a>.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="configure-variables-env-file">Import environment variables from a .env file<a href="#configure-variables-env-file" class="hash-link" aria-label="Direct link to Import environment variables from a .env file" title="Direct link to Import environment variables from a .env file" translate="no"></a></h3>
|
||
<ol>
|
||
<li class="">
|
||
<p>If Langflow is running, quit Langflow.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Create a <code>.env</code> file, and then open it in your preferred editor.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Define <a href="#supported-variables" class="">Langflow environment variables</a> in the <code>.env</code> file.</p>
|
||
<details class="details_lb9f alert alert--info details_b_Ee" data-collapsed="true"><summary>Example: .env</summary><div><div class="collapsibleContent_i85q"><div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>DO_NOT_TRACK=True</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_AUTO_LOGIN=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_AUTO_SAVING=True</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_AUTO_SAVING_INTERVAL=1000</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_BACKEND_ONLY=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_BUNDLE_URLS=["https://github.com/user/repo/commit/hash"]</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_CACHE_TYPE=async</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_COMPONENTS_PATH=/path/to/components/</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_COMPONENTS_INDEX_PATH=/path/to/component_index.json</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_CONFIG_DIR=/path/to/config/</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_DATABASE_URL=postgresql://user:password@localhost:5432/langflow</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_DEV=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_FALLBACK_TO_ENV_VAR=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_HEALTH_CHECK_MAX_RETRIES=5</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_HOST=localhost</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_LANGCHAIN_CACHE=InMemoryCache</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_MAX_FILE_SIZE_UPLOAD=10000</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_MAX_ITEMS_LENGTH=100</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_MAX_TEXT_LENGTH=1000</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_LOG_LEVEL=error</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_OPEN_BROWSER=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_PORT=7860</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_REMOVE_API_KEYS=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SAVE_DB_IN_CONFIG_DIR=True</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SECRET_KEY=somesecretkey</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_STORE_ENVIRONMENT_VARIABLES=True</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SUPERUSER=adminuser</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SUPERUSER_PASSWORD=adminpass</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_WORKER_TIMEOUT=60000</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_WORKERS=3</span></div></div><br></code></div></div><p>For additional examples, see <a href="https://github.com/langflow-ai/langflow/blob/main/.env.example" target="_blank" rel="noopener noreferrer" class=""><code>.env.example</code></a> in the Langflow repository.</p></div></div></details>
|
||
</li>
|
||
<li class="">
|
||
<p>Save and close <code>.env</code>.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Start Langflow with your <code>.env</code> file:</p>
|
||
<div class="theme-tabs-container tabs-container tabList__CuJ"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_LNqP tabs__item--active">Local</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Docker</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6"><div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>uv run langflow run --env-file .env</span></div></div><br></code></div></div></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>docker run -it --rm \</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span> -p 7860:7860 \</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span> --env-file .env \</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span> langflowai/langflow:latest</span></div></div><br></code></div></div></div></div></div>
|
||
<p>If your <code>.env</code> file isn't in the same directory, provide the path to your <code>.env</code> file.</p>
|
||
</li>
|
||
</ol>
|
||
<p>On startup, Langflow imports the environment variables from your <code>.env</code> file, as well as any others that you set in your terminal, and then adopts their specified values.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="configure-environment-variables-for-development">Configure environment variables for development<a href="#configure-environment-variables-for-development" class="hash-link" aria-label="Direct link to Configure environment variables for development" title="Direct link to Configure environment variables for development" translate="no"></a></h3>
|
||
<p>The following examples show how to configure Langflow using environment variables in different development scenarios.</p>
|
||
<div class="theme-tabs-container tabs-container tabList__CuJ"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_LNqP tabs__item--active">.env file</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Systemd service</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">VSCode tasks.json</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6"><p>The <code>.env</code> file is a text file that contains key-value pairs of environment variables.</p><p>Create or edit a <code>.env</code> file in the root directory of your application or Langflow environment, and then add your configuration variables to the file:</p><details class="details_lb9f alert alert--info details_b_Ee" data-collapsed="true"><summary>Example: .env</summary><div><div class="collapsibleContent_i85q"><div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>DO_NOT_TRACK=True</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_AUTO_LOGIN=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_AUTO_SAVING=True</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_AUTO_SAVING_INTERVAL=1000</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_BACKEND_ONLY=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_BUNDLE_URLS=["https://github.com/user/repo/commit/hash"]</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_CACHE_TYPE=async</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_COMPONENTS_PATH=/path/to/components/</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_COMPONENTS_INDEX_PATH=/path/to/component_index.json</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_CONFIG_DIR=/path/to/config/</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_DATABASE_URL=postgresql://user:password@localhost:5432/langflow</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_DEV=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_FALLBACK_TO_ENV_VAR=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_HEALTH_CHECK_MAX_RETRIES=5</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_HOST=localhost</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_LANGCHAIN_CACHE=InMemoryCache</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_MAX_FILE_SIZE_UPLOAD=10000</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_MAX_ITEMS_LENGTH=100</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_MAX_TEXT_LENGTH=1000</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_LOG_LEVEL=error</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_OPEN_BROWSER=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_PORT=7860</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_REMOVE_API_KEYS=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SAVE_DB_IN_CONFIG_DIR=True</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SECRET_KEY=somesecretkey</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_STORE_ENVIRONMENT_VARIABLES=True</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SUPERUSER=adminuser</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SUPERUSER_PASSWORD=adminpass</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_WORKER_TIMEOUT=60000</span></div></div><div><span class="ch-code-line-number">_<!-- -->30</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_WORKERS=3</span></div></div><br></code></div></div></div></div></details></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><p>A systemd service configuration file configures Linux system services.</p><p>To add environment variables, create or edit a service configuration file and add an <code>override.conf</code> file. This file allows you to override the default environment variables for the service.</p><details class="details_lb9f alert alert--info details_b_Ee" data-collapsed="true"><summary>Example: override.conf</summary><div><div class="collapsibleContent_i85q"><div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>[Service]</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="DO_NOT_TRACK=true"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_AUTO_LOGIN=false"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_AUTO_SAVING=true"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_AUTO_SAVING_INTERVAL=1000"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_BACKEND_ONLY=false"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_BUNDLE_URLS=[\"https://github.com/user/repo/commit/hash\"]"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_CACHE_TYPE=async"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_COMPONENTS_PATH=/path/to/components/"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_COMPONENTS_INDEX_PATH=/path/to/component_index.json"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_CONFIG_DIR=/path/to/config"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_DATABASE_URL=postgresql://user:password@localhost:5432/langflow"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_DEV=false"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_FALLBACK_TO_ENV_VAR=false"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_HEALTH_CHECK_MAX_RETRIES=5"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_HOST=localhost"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_LANGCHAIN_CACHE=InMemoryCache"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_MAX_FILE_SIZE_UPLOAD=10000"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_MAX_ITEMS_LENGTH=100"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_MAX_TEXT_LENGTH=1000"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_LOG_ENV=container_json"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_LOG_FILE=logs/langflow.log"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_LOG_LEVEL=error"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_OPEN_BROWSER=false"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_PORT=7860"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_REMOVE_API_KEYS=false"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_SAVE_DB_IN_CONFIG_DIR=true"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_SECRET_KEY=somesecretkey"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_STORE_ENVIRONMENT_VARIABLES=true"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_SUPERUSER=adminuser"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_SUPERUSER_PASSWORD=adminpass"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_WORKER_TIMEOUT=60000"</span></div></div><div><span class="ch-code-line-number">_<!-- -->33</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_WORKERS=3"</span></div></div><br></code></div></div></div></div></details><p>For more information on systemd, see the <a href="https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/using_systemd_unit_files_to_customize_and_optimize_your_system/assembly_working-with-systemd-unit-files_working-with-systemd" target="_blank" rel="noopener noreferrer" class="">Red Hat documentation</a>.</p></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><p>The <code>tasks.json</code> file located in <code>.vscode/tasks.json</code> is a configuration file for development environments using Visual Studio Code.</p><p>Create or edit the <code>.vscode/tasks.json</code> file in your project root.</p><details class="details_lb9f alert alert--info details_b_Ee" data-collapsed="true"><summary>Example: .vscode/tasks.json</summary><div><div class="collapsibleContent_i85q"><div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span>{</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "version": "2.0.0",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "options": {</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "env": {</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "DO_NOT_TRACK": "true",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_AUTO_LOGIN": "false",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_AUTO_SAVING": "true",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_AUTO_SAVING_INTERVAL": "1000",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_BACKEND_ONLY": "false",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_BUNDLE_URLS": "[\"https://github.com/user/repo/commit/hash\"]",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_CACHE_TYPE": "async",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_COMPONENTS_PATH": "D:/path/to/components/",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_COMPONENTS_INDEX_PATH": "D:/path/to/component_index.json",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_CONFIG_DIR": "D:/path/to/config/",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_DATABASE_URL": "postgresql://postgres:password@localhost:5432/langflow",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_DEV": "false",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_FALLBACK_TO_ENV_VAR": "false",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_HEALTH_CHECK_MAX_RETRIES": "5",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_HOST": "localhost",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_LANGCHAIN_CACHE": "InMemoryCache",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_MAX_FILE_SIZE_UPLOAD": "10000",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_MAX_ITEMS_LENGTH": "100",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_MAX_TEXT_LENGTH": "1000",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_LOG_ENV": "container_csv",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_LOG_FILE": "langflow.log",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_LOG_LEVEL": "error",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_OPEN_BROWSER": "false",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_PORT": "7860",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_REMOVE_API_KEYS": "true",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_SAVE_DB_IN_CONFIG_DIR": "false",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_SECRET_KEY": "somesecretkey",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_STORE_ENVIRONMENT_VARIABLES": "true",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_SUPERUSER": "adminuser",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_SUPERUSER_PASSWORD": "adminpass",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_WORKER_TIMEOUT": "60000",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_WORKERS": "3"</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> }</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> },</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "tasks": [</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> {</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "label": "langflow backend",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "type": "shell",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "command": ". ./langflownightly/Scripts/activate && langflow run",</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "isBackground": true,</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> "problemMatcher": []</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> }</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span> ]</span></div></div><div><span class="ch-code-line-number">_<!-- -->48</span><div style="display:inline-block;margin-left:16px"><span>}</span></div></div><br></code></div></div></div></div></details><p>To run Langflow using the above VSCode <code>tasks.json</code> file, in the VSCode command palette, select <strong>Tasks: Run Task</strong> > <strong>langflow backend</strong>.</p></div></div></div>
|
||
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="set-environment-variables-for-langflow-desktop">Set environment variables for Langflow Desktop<a href="#set-environment-variables-for-langflow-desktop" class="hash-link" aria-label="Direct link to Set environment variables for Langflow Desktop" title="Direct link to Set environment variables for Langflow Desktop" translate="no"></a></h2>
|
||
<p>Environment variables set in your terminal aren't automatically available to GUI-based applications like Langflow Desktop when you launch them from the Windows or macOS GUI.</p>
|
||
<p>To modify environment variables for Langflow Desktop, set environment variables in a Desktop <code>.env</code> file, and then restart the app.</p>
|
||
<div class="theme-tabs-container tabs-container tabList__CuJ"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_LNqP tabs__item--active">macOS</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Windows .env file</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Windows user environment variables</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6"><p>To modify the macOS <code>.env</code> file, do the following:</p><ol>
|
||
<li class="">
|
||
<p>Create or edit <code>~/.langflow/data/.env</code>.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Add your Langflow environment variables, for example:</p>
|
||
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_LOG_LEVEL=info</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_DOCLING=true</span></div></div><br></code></div></div>
|
||
</li>
|
||
<li class="">
|
||
<p>Save the file.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Restart Langflow Desktop.</p>
|
||
</li>
|
||
</ol></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><p>To modify the Windows <code>.env</code> file, do the following:</p><ol>
|
||
<li class="">
|
||
<p>Create or edit <code>%APPDATA%\com.LangflowDesktop\data\.env</code>.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Add your Langflow environment variables, for example:</p>
|
||
<div class="ch-codeblock not-prose" data-ch-theme="github-dark"><div class="ch-code-wrapper ch-code" data-ch-measured="false"><code class="ch-code-scroll-parent"><br><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_LOG_LEVEL=info</span></div></div><div><span class="ch-code-line-number">_<!-- -->10</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_DOCLING=true</span></div></div><br></code></div></div>
|
||
</li>
|
||
<li class="">
|
||
<p>Save the file.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Restart Langflow Desktop.</p>
|
||
</li>
|
||
</ol></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><p>Windows supports two sources for Langflow Desktop environment variables: a Langflow application <code>.env</code> file, and Windows user environment variables.</p><p>The <code>.env</code> file at <code>%APPDATA%\com.LangflowDesktop\data\.env</code> is the recommended approach, but
|
||
Windows user variables are useful for single-sourcing API keys between Langflow and other Windows applications.
|
||
If the same variable is defined in both the Langflow application <code>.env</code> file and as a Windows user environment variable, the <code>.env</code> file takes precedence.</p><p>To modify the Windows user environment variables, do the following:</p><ol>
|
||
<li class="">Press <kbd>Win + R</kbd>, enter <code>sysdm.cpl</code>, and then press <kbd>Enter</kbd>.</li>
|
||
<li class="">Click the <strong>Advanced</strong> tab, and then click <strong>Environment Variables</strong>.</li>
|
||
<li class="">In <strong>User variables</strong>, click <strong>New</strong>.</li>
|
||
<li class="">Enter the variable name, such as <code>OPENAI_API_KEY</code>, and its value.</li>
|
||
<li class="">Click <strong>OK</strong>, and then <strong>restart Langflow Desktop</strong>.</li>
|
||
</ol></div></div></div>
|
||
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="supported-variables">Supported environment variables<a href="#supported-variables" class="hash-link" aria-label="Direct link to Supported environment variables" title="Direct link to Supported environment variables" translate="no"></a></h2>
|
||
<p>The following sections provide information about specific Langflow environment variables.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="authentication-and-security">Authentication and security<a href="#authentication-and-security" class="hash-link" aria-label="Direct link to Authentication and security" title="Direct link to Authentication and security" translate="no"></a></h3>
|
||
<p>See <a class="" href="/api-keys-and-authentication">API keys and authentication</a>.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="global-variables">Global variables<a href="#global-variables" class="hash-link" aria-label="Direct link to Global variables" title="Direct link to Global variables" translate="no"></a></h3>
|
||
<p>For information about the relationship between Langflow global variables and environment variables, as well as environment variables that control handling of global variables, see <a class="" href="/configuration-global-variables">Global variables</a>.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="logging">Logs<a href="#logging" class="hash-link" aria-label="Direct link to Logs" title="Direct link to Logs" translate="no"></a></h3>
|
||
<p>See <a class="" href="/logging#log-storage">Configure log options</a>.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="mcp">MCP servers<a href="#mcp" class="hash-link" aria-label="Direct link to MCP servers" title="Direct link to MCP servers" translate="no"></a></h3>
|
||
<p>See <a class="" href="/mcp-server">Use Langflow as an MCP server</a>.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="monitoring-and-metrics">Monitoring and metrics<a href="#monitoring-and-metrics" class="hash-link" aria-label="Direct link to Monitoring and metrics" title="Direct link to Monitoring and metrics" translate="no"></a></h3>
|
||
<p>For environment variables for specific monitoring service providers, see the Langflow monitoring integration guides, such as <a class="" href="/integrations-langfuse">Langfuse</a> and <a class="" href="/deployment-prod-best-practices">Best practices for Langflow on Kubernetes</a>.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="server">Server<a href="#server" class="hash-link" aria-label="Direct link to Server" title="Direct link to Server" translate="no"></a></h3>
|
||
<p>The following environment variables set base Langflow server configuration, such as where the server is hosted, required files for SSL encryption, and the deployment type (frontend and backend, backend-only, development mode).</p>
|
||
<table><thead><tr><th>Variable</th><th>Format</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td><code>LANGFLOW_HOST</code></td><td>String</td><td><code>localhost</code></td><td>The host on which the Langflow server will run.</td></tr><tr><td><code>LANGFLOW_PORT</code></td><td>Integer</td><td><code>7860</code></td><td>The port on which the Langflow server runs. The server automatically selects a free port if the specified port is in use.</td></tr><tr><td><code>LANGFLOW_BACKEND_ONLY</code></td><td>Boolean</td><td><code>False</code></td><td>Run only the Langflow backend service (no frontend).</td></tr><tr><td><code>LANGFLOW_DEV</code></td><td>Boolean</td><td><code>False</code></td><td>Whether to run Langflow in development mode (may contain bugs).</td></tr><tr><td><code>LANGFLOW_OPEN_BROWSER</code></td><td>Boolean</td><td><code>False</code></td><td>Open the system web browser on startup.</td></tr><tr><td><code>LANGFLOW_HEALTH_CHECK_MAX_RETRIES</code></td><td>Integer</td><td><code>5</code></td><td>Set the maximum number of retries for Langflow's server status health checks.</td></tr><tr><td><code>LANGFLOW_WORKERS</code></td><td>Integer</td><td><code>1</code></td><td>Number of worker processes.</td></tr><tr><td><code>LANGFLOW_WORKER_TIMEOUT</code></td><td>Integer</td><td><code>300</code></td><td>Worker timeout in seconds.</td></tr><tr><td><code>LANGFLOW_SSL_CERT_FILE</code></td><td>String</td><td>Not set</td><td>Path to the SSL certificate file for enabling HTTPS on the Langflow web server. This is separate from <a class="" href="/configuration-custom-database#connect-langflow-to-a-local-postgresql-database">database SSL connections</a>.</td></tr><tr><td><code>LANGFLOW_SSL_KEY_FILE</code></td><td>String</td><td>Not set</td><td>Path to the SSL key file for enabling HTTPS on the Langflow web server. This is separate from <a class="" href="/configuration-custom-database#connect-langflow-to-a-local-postgresql-database">database SSL connections</a>.</td></tr><tr><td><code>LANGFLOW_DEACTIVATE_TRACING</code></td><td>Boolean</td><td><code>False</code></td><td>Deactivate tracing functionality.</td></tr><tr><td><code>LANGFLOW_CELERY_ENABLED</code></td><td>Boolean</td><td><code>False</code></td><td>Enable Celery for distributed task processing.</td></tr><tr><td><code>LANGFLOW_ALEMBIC_LOG_TO_STDOUT</code></td><td>Boolean</td><td><code>False</code></td><td>Whether to log Alembic database migration output to stdout instead of a log file. If <code>true</code>, Alembic logs to <code>stdout</code> and the default log file is ignored.</td></tr></tbody></table>
|
||
<p>For more information about deploying Langflow servers, see <a class="" href="/deployment-overview">Langflow deployment overview</a>.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="storage">Storage<a href="#storage" class="hash-link" aria-label="Direct link to Storage" title="Direct link to Storage" translate="no"></a></h3>
|
||
<p>For file storage environment variables, see <a class="" href="/concepts-file-management#file-storage-environment-variables">File storage environment variables</a>.</p>
|
||
<p>For database environment variables, including PostgreSQL configuration, see <a class="" href="/memory#configure-external-memory">Memory management options</a>.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="telemetry">Telemetry<a href="#telemetry" class="hash-link" aria-label="Direct link to Telemetry" title="Direct link to Telemetry" translate="no"></a></h3>
|
||
<p>See <a class="" href="/contributing-telemetry">Telemetry</a>.</p>
|
||
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="visual-editor-and-playground-behavior">Visual editor and Playground behavior<a href="#visual-editor-and-playground-behavior" class="hash-link" aria-label="Direct link to Visual editor and Playground behavior" title="Direct link to Visual editor and Playground behavior" translate="no"></a></h3>
|
||
<table><thead><tr><th>Variable</th><th>Format</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td><code>LANGFLOW_AUTO_SAVING</code></td><td>Boolean</td><td><code>True</code></td><td>Whether to automatically save the current flow draft. Auto-save only updates the live draft, and doesn't create <a class="" href="/concepts-flows#save-and-restore-flow-versions">saved flow versions</a>.</td></tr><tr><td><code>LANGFLOW_AUTO_SAVING_INTERVAL</code></td><td>Integer</td><td><code>1000</code></td><td>Set the auto-save interval in milliseconds if <code>LANGFLOW_AUTO_SAVING=True</code>.</td></tr><tr><td><code>LANGFLOW_BUNDLE_URLS</code></td><td>List[String]</td><td><code>[]</code></td><td>A list of URLs from which to load custom bundles. Supports GitHub URLs. If <code>LANGFLOW_AUTO_LOGIN=True</code>, flows from these bundles are loaded into the database.</td></tr><tr><td><code>LANGFLOW_COMPONENTS_PATH</code></td><td>String</td><td>Not set</td><td>Path to a directory containing custom components. Typically used if you have local custom components or you are building a Docker image with custom components.</td></tr><tr><td><code>LANGFLOW_COMPONENTS_INDEX_PATH</code></td><td>String</td><td>Not set</td><td>File path or URL (<code>http://</code> or <code>https://</code>) to a prebuilt component index JSON file used to populate built-in components in the visual editor. When not set, Langflow uses the included index. Useful for supplying a curated component index, for example in airgapped deployments. For more information, see <a class="" href="/deployment-block-custom-components">Block custom components</a>.</td></tr><tr><td><code>LANGFLOW_ALLOW_CUSTOM_COMPONENTS</code></td><td>Boolean</td><td><code>True</code></td><td>If <code>false</code>, disables custom components and in-editor editing of component code. This feature is in beta. For more information, see <a class="" href="/deployment-block-custom-components">Block custom components</a>.</td></tr><tr><td><code>LANGFLOW_LOAD_FLOWS_PATH</code></td><td>String</td><td>Not set</td><td>Path to a directory containing flow JSON files to be loaded on startup. Typically used when creating a Docker image with prepackaged flows. Requires <code>LANGFLOW_AUTO_LOGIN=True</code>.</td></tr><tr><td><code>LANGFLOW_CREATE_STARTER_PROJECTS</code></td><td>Boolean</td><td><code>True</code></td><td>Whether to create templates during initialization. If <code>false</code>, Langflow doesn't create templates, and <code>LANGFLOW_UPDATE_STARTER_PROJECTS</code> is treated as <code>false</code>.</td></tr><tr><td><code>LANGFLOW_UPDATE_STARTER_PROJECTS</code></td><td>Boolean</td><td><code>True</code></td><td>Whether to update templates with the latest component versions when initializing after an upgrade.</td></tr><tr><td><code>LANGFLOW_LAZY_LOAD_COMPONENTS</code></td><td>Boolean</td><td><code>False</code></td><td>If <code>true</code>, Langflow only partially loads components at startup and fully loads them on demand. This significantly reduces startup time but can cause a slight delay when a component is first used.</td></tr><tr><td><code>LANGFLOW_EVENT_DELIVERY</code></td><td>String</td><td><code>streaming</code></td><td>How to deliver build events to the frontend: <code>polling</code>, <code>streaming</code> or <code>direct</code>.</td></tr><tr><td><code>LANGFLOW_FRONTEND_PATH</code></td><td>String</td><td><code>./frontend</code></td><td>Path to the frontend directory containing build files. For development purposes only when you need to serve specific frontend code.</td></tr><tr><td><code>LANGFLOW_MAX_ITEMS_LENGTH</code></td><td>Integer</td><td><code>100</code></td><td>Maximum number of items to store and display in the visual editor. Lists longer than this will be truncated when displayed in the visual editor. Doesn't affect outputs or data passed between components.</td></tr><tr><td><code>LANGFLOW_MAX_TEXT_LENGTH</code></td><td>Integer</td><td><code>1000</code></td><td>Maximum number of characters to store and display in the visual editor. Responses longer than this will be truncated when displayed in the visual editor. Doesn't truncate outputs or responses passed between components.</td></tr><tr><td><code>LANGFLOW_MAX_TRANSACTIONS_TO_KEEP</code></td><td>Integer</td><td><code>3000</code></td><td>Maximum number of flow transaction events to keep in the database.</td></tr><tr><td><code>LANGFLOW_MAX_VERTEX_BUILDS_TO_KEEP</code></td><td>Integer</td><td><code>3000</code></td><td>Maximum number of vertex builds to keep in the database. Relates to <a class="" href="/concepts-playground">Playground</a> functionality.</td></tr><tr><td><code>LANGFLOW_MAX_VERTEX_BUILDS_PER_VERTEX</code></td><td>Integer</td><td><code>2</code></td><td>Maximum number of builds to keep per vertex. Older builds are deleted. Relates to <a class="" href="/concepts-playground">Playground</a> functionality.</td></tr><tr><td><code>LANGFLOW_PUBLIC_FLOW_CLEANUP_INTERVAL</code></td><td>Integer</td><td><code>3600</code></td><td>The interval in seconds at which data for <a class="" href="/concepts-playground#share-a-flows-playground">shared Playground</a> flows are cleaned up. Default: 3600 seconds (1 hour). Minimum: 600 seconds (10 minutes).</td></tr><tr><td><code>LANGFLOW_PUBLIC_FLOW_EXPIRATION</code></td><td>Integer</td><td><code>86400</code></td><td>The time in seconds after which a <a class="" href="/concepts-playground#share-a-flows-playground">shared Playground</a> flow is considered expired and eligible for cleanup. Default: 86400 seconds (24 hours). Minimum: 600 seconds (10 minutes).</td></tr></tbody></table></div></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/configuration-global-variables"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Global variables</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/concepts-file-management"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Manage files</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#configure-environment-variables-for-langflow-oss" class="table-of-contents__link toc-highlight">Configure environment variables for Langflow OSS</a><ul><li><a href="#precedence" class="table-of-contents__link toc-highlight">Precedence</a></li><li><a href="#configure-variables-terminal" class="table-of-contents__link toc-highlight">Set environment variables in your terminal</a></li><li><a href="#configure-variables-env-file" class="table-of-contents__link toc-highlight">Import environment variables from a .env file</a></li><li><a href="#configure-environment-variables-for-development" class="table-of-contents__link toc-highlight">Configure environment variables for development</a></li></ul></li><li><a href="#set-environment-variables-for-langflow-desktop" class="table-of-contents__link toc-highlight">Set environment variables for Langflow Desktop</a></li><li><a href="#supported-variables" class="table-of-contents__link toc-highlight">Supported environment variables</a><ul><li><a href="#authentication-and-security" class="table-of-contents__link toc-highlight">Authentication and security</a></li><li><a href="#global-variables" class="table-of-contents__link toc-highlight">Global variables</a></li><li><a href="#logging" class="table-of-contents__link toc-highlight">Logs</a></li><li><a href="#mcp" class="table-of-contents__link toc-highlight">MCP servers</a></li><li><a href="#monitoring-and-metrics" class="table-of-contents__link toc-highlight">Monitoring and metrics</a></li><li><a href="#server" class="table-of-contents__link toc-highlight">Server</a></li><li><a href="#storage" class="table-of-contents__link toc-highlight">Storage</a></li><li><a href="#telemetry" class="table-of-contents__link toc-highlight">Telemetry</a></li><li><a href="#visual-editor-and-playground-behavior" class="table-of-contents__link toc-highlight">Visual editor and Playground behavior</a></li></ul></li></ul></div></div></div></div></main></div></div></div><footer class="theme-layout-footer footer"><div class="container container-fluid"><div class="row footer__links"><div class="theme-layout-footer-column col footer__col"><div class="footer__title"></div><ul class="footer__items clean-list"><li class="footer__item"><div class="footer-links">
|
||
<span>© 2026 Langflow</span>
|
||
<span id="preferenceCenterContainer"> · <a href="#" onclick='return"undefined"!=typeof window&&window.truste&&window.truste.eu&&window.truste.eu.clickListener&&window.truste.eu.clickListener(),!1' style="cursor: pointer;">Manage Privacy Choices</a></span>
|
||
</div></li></ul></div></div></div></footer><div style="position:fixed;right:21px;bottom:21px;z-index:100;display:flex;align-items:center;gap:10px;cursor:pointer"><div style="background-color:#f6f6f6;border-radius:50%;width:48px;height:48px;display:flex;align-items:center;justify-content:center;box-shadow:0 2px 4px rgba(0,0,0,0.1)"><img src="/img/langflow-icon-black-transparent.svg" style="width:40px" alt="Search"></div></div></div>
|
||
</body>
|
||
</html> |