mirror of
https://github.com/langflow-ai/langflow.git
synced 2026-07-24 07:34:10 +08:00
196 lines
82 KiB
HTML
196 lines
82 KiB
HTML
<!doctype html>
|
||
<html lang="en" dir="ltr" class="docs-wrapper plugin-docs plugin-id-default docs-version-current 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="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><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=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.403c62aa.css">
|
||
<script src="/assets/js/runtime~main.a683cc49.js" defer="defer"></script>
|
||
<script src="/assets/js/main.d08ead96.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 navbarHideable_m1mJ"><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><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" 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" 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" 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_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" 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" class="toggleIcon_g3eP lightToggleIcon_pyhR"><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" class="toggleIcon_g3eP darkToggleIcon_wfgR"><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" class="toggleIcon_g3eP systemToggleIcon_QzmC"><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 class="theme-doc-sidebar-container docSidebarContainer_YfHR"><div class="sidebarViewport_aRkj"><div class="sidebar_njMd sidebarWithHideableNavbar_wUlq"><a tabindex="-1" class="sidebarLogo_isFc" href="/"><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"></a><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-category theme-doc-sidebar-item-category-level-1 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" 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"><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"><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"><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-category theme-doc-sidebar-item-category-level-1 menu__list-item"><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="/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"><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-category theme-doc-sidebar-item-category-level-1 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" 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"><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-category theme-doc-sidebar-item-category-level-1 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" 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"><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" class="menu__link">
|
||
<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||
<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_VOVn"><div class="docItemContainer_Djhp"><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" class="breadcrumbHomeIcon_YNFT"><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="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 anchorTargetHideOnScrollNavbar_vjPI" 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 anchorTargetHideOnScrollNavbar_vjPI" 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 anchorTargetHideOnScrollNavbar_vjPI" 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 anchorTargetHideOnScrollNavbar_vjPI" 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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>DO_NOT_TRACK=True</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_AUTO_LOGIN=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_AUTO_SAVING=True</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_BACKEND_ONLY=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_CACHE_TYPE=async</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</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">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_DEV=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_HOST=localhost</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_LANGCHAIN_CACHE=InMemoryCache</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</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">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_LOG_LEVEL=error</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_OPEN_BROWSER=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_PORT=7860</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SECRET_KEY=somesecretkey</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SUPERUSER=adminuser</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SUPERUSER_PASSWORD=adminpass</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_WORKER_TIMEOUT=60000</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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 anchorTargetHideOnScrollNavbar_vjPI" 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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>DO_NOT_TRACK=True</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_AUTO_LOGIN=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_AUTO_SAVING=True</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_BACKEND_ONLY=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_CACHE_TYPE=async</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</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">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_DEV=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_HOST=localhost</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_LANGCHAIN_CACHE=InMemoryCache</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</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">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_LOG_LEVEL=error</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_OPEN_BROWSER=False</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_PORT=7860</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SECRET_KEY=somesecretkey</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SUPERUSER=adminuser</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_SUPERUSER_PASSWORD=adminpass</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</span><div style="display:inline-block;margin-left:16px"><span>LANGFLOW_WORKER_TIMEOUT=60000</span></div></div><div><span class="ch-code-line-number">_<!-- -->29</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">_<!-- -->32</span><div style="display:inline-block;margin-left:16px"><span>[Service]</span></div></div><div><span class="ch-code-line-number">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_DEV=false"</span></div></div><div><span class="ch-code-line-number">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_HOST=localhost"</span></div></div><div><span class="ch-code-line-number">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_PORT=7860"</span></div></div><div><span class="ch-code-line-number">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</span><div style="display:inline-block;margin-left:16px"><span>Environment="LANGFLOW_SUPERUSER=adminuser"</span></div></div><div><span class="ch-code-line-number">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->32</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">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span>{</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "version": "2.0.0",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "options": {</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "env": {</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "DO_NOT_TRACK": "true",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_AUTO_LOGIN": "false",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_AUTO_SAVING": "true",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</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">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_BACKEND_ONLY": "false",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</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">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_CACHE_TYPE": "async",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</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">_<!-- -->47</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">_<!-- -->47</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">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_DEV": "false",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</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">_<!-- -->47</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">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_HOST": "localhost",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_LANGCHAIN_CACHE": "InMemoryCache",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</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">_<!-- -->47</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">_<!-- -->47</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">_<!-- -->47</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">_<!-- -->47</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">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_LOG_LEVEL": "error",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_OPEN_BROWSER": "false",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_PORT": "7860",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</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">_<!-- -->47</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">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_SECRET_KEY": "somesecretkey",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</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">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_SUPERUSER": "adminuser",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_SUPERUSER_PASSWORD": "adminpass",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_WORKER_TIMEOUT": "60000",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "LANGFLOW_WORKERS": "3"</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> }</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> },</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "tasks": [</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> {</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "label": "langflow backend",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "type": "shell",</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</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">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "isBackground": true,</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> "problemMatcher": []</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> }</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</span><div style="display:inline-block;margin-left:16px"><span> ]</span></div></div><div><span class="ch-code-line-number">_<!-- -->47</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 anchorTargetHideOnScrollNavbar_vjPI" 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>For Windows, this means any GUI-based app launched from the Start menu, desktop shortcuts, or Windows Explorer.</p>
|
||
<p>For macOS, this means any GUI-based app launched from Finder, Spotlight, Launchpad, or the Dock.</p>
|
||
<p>To set environment variables for Langflow Desktop, you need to use specific commands or files, depending on your OS.</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">Window System Properties</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Powershell</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6"><p>Langflow Desktop for macOS cannot automatically use variables set in your terminal, such as those in<code>.zshrc</code> or <code>.bash_profile</code>, when launched from the macOS GUI.</p><p>To make environment variables available to GUI apps on macOS, you need to use <code>launchctl</code> with a <code>plist</code> file:</p><ol>
|
||
<li class="">
|
||
<p>Create the <code>LaunchAgents</code> directory if it doesn't exist:</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>mkdir -p ~/Library/LaunchAgents</span></div></div><br></code></div></div>
|
||
</li>
|
||
<li class="">
|
||
<p>In the <code>LaunchAgents</code> directory, create a <code>.plist</code> file called <code>dev.langflow.env</code>.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Add the following content to <code>dev.langflow.env.plist</code>, and then add, change, or remove Langflow environment variables as needed for your configuration.</p>
|
||
<p>This example sets multiple environmental variables for all GUI apps launched from the macOS GUI.</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">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> <?xml version="1.0" encoding="UTF-8"?></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> <plist version="1.0"></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> <dict></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> <key>Label</key></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> <string>dev.langflow.env</string></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> <key>ProgramArguments</key></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> <array></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> <string>/bin/sh</string></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> <string>-c</string></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> <string></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> launchctl setenv LANGFLOW_CONFIG_DIR /Users/your_user/custom/config ;</span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> launchctl setenv LANGFLOW_PORT 7860 ;</span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> launchctl setenv LANGFLOW_HOST localhost ;</span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> launchctl setenv ARIZE_API_KEY ak-...</span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> </string></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> </array></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> <key>RunAtLoad</key></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> <true/></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> </dict></span></div></div><div><span class="ch-code-line-number">_<!-- -->21</span><div style="display:inline-block;margin-left:16px"><span> </plist></span></div></div><br></code></div></div>
|
||
</li>
|
||
<li class="">
|
||
<p>Load the file with <code>launchctl</code>:</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>launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/dev.langflow.env.plist</span></div></div><br></code></div></div>
|
||
</li>
|
||
</ol></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><p>Langflow Desktop for Windows cannot automatically use variables set in your terminal, such as those defined with <code>set</code> in <code>cmd</code> or <code>$env:VAR=...</code> in PowerShell, when launched from the Windows GUI.</p><p>To make environment variables available to the Langflow Desktop app, you must set them at the user or system level using the <strong>System Properties</strong> interface or the Terminal.</p><p>To set environment variables using the System Properties interface, do the following:</p><ol>
|
||
<li class="">
|
||
<p>Press <kbd>Win + R</kbd>, enter <code>SystemPropertiesAdvanced</code>, and then press <kbd>Enter</kbd>.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Click <strong>Environment Variables</strong>.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Under <strong>User variables</strong>, click <strong>New</strong>.</p>
|
||
<div class="theme-admonition theme-admonition-tip admonition_xJq3 alert alert--success"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 12 16"><path fill-rule="evenodd" d="M6.5 0C3.48 0 1 2.19 1 5c0 .92.55 2.25 1 3 1.34 2.25 1.78 2.78 2 4v1h5v-1c.22-1.22.66-1.75 2-4 .45-.75 1-2.08 1-3 0-2.81-2.48-5-5.5-5zm3.64 7.48c-.25.44-.47.8-.67 1.11-.86 1.41-1.25 2.06-1.45 3.23-.02.05-.02.11-.02.17H5c0-.06 0-.13-.02-.17-.2-1.17-.59-1.83-1.45-3.23-.2-.31-.42-.67-.67-1.11C2.44 6.78 2 5.65 2 5c0-2.2 2.02-4 4.5-4 1.22 0 2.36.42 3.22 1.19C10.55 2.94 11 3.94 11 5c0 .66-.44 1.78-.86 2.48zM4 14h5c-.23 1.14-1.3 2-2.5 2s-2.27-.86-2.5-2z"></path></svg></span>tip</div><div class="admonitionContent_BuS1"><p>To apply the setting to all users, select <strong>System variables</strong>.</p></div></div>
|
||
</li>
|
||
<li class="">
|
||
<p>Enter the name of the Langflow variable you want to set, such as <code>LANGFLOW_CONFIG_DIR</code>, and the desired value, such as <code>C:\Users\your_user\.langflow_config</code>.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Click <strong>OK</strong> to save the variable.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Repeat until you have set all necessary Langflow environment variables.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Launch or restart Langflow Desktop to apply the environment variables.</p>
|
||
</li>
|
||
</ol></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><p>To define environment variables for Windows using PowerShell, do the following:</p><ol>
|
||
<li class="">
|
||
<p>Enter the name of the Langflow variable you want to set, such as <code>LANGFLOW_CONFIG_DIR</code>, and the desired value, such as <code>C:\Users\your_user\.langflow_config</code>.</p>
|
||
<p>To set an environment variable for the current user:</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>[System.Environment]::SetEnvironmentVariable("LANGFLOW_CONFIG_DIR", "C:\Users\your_user\.langflow_config", "User")</span></div></div><br></code></div></div>
|
||
<p>To set an environment variable for all users (you must have Administrator priveleges):</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>[System.Environment]::SetEnvironmentVariable("LANGFLOW_CONFIG_DIR", "C:\Langflow\Config", "Machine")</span></div></div><br></code></div></div>
|
||
</li>
|
||
<li class="">
|
||
<p>Repeat until you have set all necessary Langflow environment variables.</p>
|
||
</li>
|
||
<li class="">
|
||
<p>Launch or restart Langflow Desktop to apply the environment variables.</p>
|
||
</li>
|
||
</ol></div></div></div>
|
||
<h2 class="anchor anchorTargetHideOnScrollNavbar_vjPI" 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 anchorTargetHideOnScrollNavbar_vjPI" 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 anchorTargetHideOnScrollNavbar_vjPI" 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 anchorTargetHideOnScrollNavbar_vjPI" 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 anchorTargetHideOnScrollNavbar_vjPI" 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 anchorTargetHideOnScrollNavbar_vjPI" 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 anchorTargetHideOnScrollNavbar_vjPI" 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 anchorTargetHideOnScrollNavbar_vjPI" 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 anchorTargetHideOnScrollNavbar_vjPI" 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 anchorTargetHideOnScrollNavbar_vjPI" 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 flows.</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_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> |