gmakstutis/openrag
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

deploy: a778cd76fa

Browse source
This commit is contained in:
aimurphy 2025-12-03 19:20:11 +00:00
parent 53e8d16ed7
commit b2e32dac7b
26 changed files with 231 additions and 119 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
404.html
View file

@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">OpenRAG</title><meta data-rh="true" property="og:title" content="OpenRAG"><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="robots" content="noindex, nofollow"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openr.ag/404.html"><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"><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.openr.ag/404.html"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/404.html" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/404.html" hreflang="x-default"><link rel="stylesheet" href="/assets/css/styles.66669ecc.css">
<script src="/assets/js/runtime~main.f46e5be3.js" defer="defer"></script>
<script src="/assets/js/runtime~main.a3cb74e9.js" defer="defer"></script>
<script src="/assets/js/main.86159c47.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">

2
agents/index.html
View file

@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">Use Langflow in OpenRAG | OpenRAG</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="robots" content="noindex, nofollow"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openr.ag/agents"><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="Use Langflow in OpenRAG | OpenRAG"><meta data-rh="true" name="description" content="OpenRAG includes a built-in Langflow instance for creating and managing functional application workflows called flows."><meta data-rh="true" property="og:description" content="OpenRAG includes a built-in Langflow instance for creating and managing functional application workflows called flows."><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.openr.ag/agents"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/agents" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/agents" hreflang="x-default"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Flows","item":"https://docs.openr.ag/agents"}]}</script><link rel="stylesheet" href="/assets/css/styles.66669ecc.css">
<script src="/assets/js/runtime~main.f46e5be3.js" defer="defer"></script>
<script src="/assets/js/runtime~main.a3cb74e9.js" defer="defer"></script>
<script src="/assets/js/main.86159c47.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">

1
assets/js/0ba6a408.dd2bbad9.js
View file

File diff suppressed because one or more lines are too long

1
assets/js/0ba6a408.eddb3e7e.js Normal file
View file

File diff suppressed because one or more lines are too long

1
assets/js/27b4a875.565e61ee.js
View file

File diff suppressed because one or more lines are too long

1
assets/js/27b4a875.8de9f81c.js Normal file
View file

File diff suppressed because one or more lines are too long

1
assets/js/71478a5d.57b0036a.js Normal file
View file

File diff suppressed because one or more lines are too long

1
assets/js/71478a5d.7641035a.js
View file

File diff suppressed because one or more lines are too long

1
assets/js/749371cc.7bf165c7.js Normal file
View file

File diff suppressed because one or more lines are too long

1
assets/js/749371cc.ed259beb.js
View file

File diff suppressed because one or more lines are too long

2
assets/js/ca2c3c0c.04fbbb9d.js → assets/js/ca2c3c0c.7114a4c2.js
View file

File diff suppressed because one or more lines are too long

1
assets/js/d0314b07.26db9c14.js Normal file
View file

File diff suppressed because one or more lines are too long

1
assets/js/d0314b07.86b4cd81.js
View file

File diff suppressed because one or more lines are too long

1
assets/js/eb5b356a.285e3b8b.js Normal file
View file

File diff suppressed because one or more lines are too long

1
assets/js/eb5b356a.6122add2.js
View file

File diff suppressed because one or more lines are too long

2
assets/js/runtime~main.f46e5be3.js → assets/js/runtime~main.a3cb74e9.js
View file

@ -1 +1 @@
(()=>{"use strict";var e,a,r,t,o,c={},d={};function f(e){var a=d[e];if(void 0!==a)return a.exports;var r=d[e]={id:e,loaded:!1,exports:{}};return c[e].call(r.exports,r,r.exports,f),r.loaded=!0,r.exports}f.m=c,f.c=d,e=[],f.O=(a,r,t,o)=>{if(!r){var c=1/0;for(i=0;i<e.length;i++){for(var[r,t,o]=e[i],d=!0,n=0;n<r.length;n++)(!1&o||c>=o)&&Object.keys(f.O).every(e=>f.O[e](r[n]))?r.splice(n--,1):(d=!1,o<c&&(c=o));if(d){e.splice(i--,1);var b=t();void 0!==b&&(a=b)}}return a}o=o||0;for(var i=e.length;i>0&&e[i-1][2]>o;i--)e[i]=e[i-1];e[i]=[r,t,o]},f.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return f.d(a,{a:a}),a},r=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,f.t=function(e,t){if(1&t&&(e=this(e)),8&t)return e;if("object"==typeof e&&e){if(4&t&&e.__esModule)return e;if(16&t&&"function"==typeof e.then)return e}var o=Object.create(null);f.r(o);var c={};a=a||[null,r({}),r([]),r(r)];for(var d=2&t&&e;("object"==typeof d||"function"==typeof d)&&!~a.indexOf(d);d=r(d))Object.getOwnPropertyNames(d).forEach(a=>c[a]=()=>e[a]);return c.default=()=>e,f.d(o,c),o},f.d=(e,a)=>{for(var r in a)f.o(a,r)&&!f.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:a[r]})},f.f={},f.e=e=>Promise.all(Object.keys(f.f).reduce((a,r)=>(f.f[r](e,a),a),[])),f.u=e=>"assets/js/"+({98:"af920ffe",571:"0ba6a408",1567:"22dd74f7",2076:"common",2272:"749371cc",2668:"eb5b356a",3207:"27b4a875",5490:"71478a5d",5742:"aba21aa0",5750:"d0314b07",6919:"ca2c3c0c",7098:"a7bd4aaa",8401:"17896441",9026:"c8078f0a",9048:"a94703ab",9172:"e633a5ea",9532:"33362219",9647:"5e95c892"}[e]||e)+"."+{98:"f3ba20bd",165:"7b1d067d",291:"1b64972f",571:"dd2bbad9",617:"e8fa27b8",1e3:"f9af7a41",1203:"b618bb61",1567:"bcf46a1b",1741:"b927934f",1746:"c8a2211b",2076:"6bf331d5",2130:"09232a19",2237:"70c48bab",2272:"ed259beb",2279:"12a16213",2291:"2c483c10",2325:"7c4239a7",2334:"daa16321",2492:"e6c78669",2668:"6122add2",2821:"e806cb03",3207:"565e61ee",3490:"026802f4",3815:"f87fc96a",4250:"77e8e6c6",4616:"b519f330",4802:"a8b2857c",4981:"61cf4b0a",5480:"cd9ee90b",5490:"7641035a",5742:"2f625fe1",5750:"86b4cd81",5901:"f6ccb00b",5955:"14464ff3",5996:"16c59d9f",6241:"11caa48e",6319:"4754ec94",6366:"0c77f825",6567:"b1623b8d",6919:"04fbbb9d",6992:"3c4d161b",7098:"9fea9356",7465:"7e0b8008",7592:"d6165eff",7873:"547873d3",7928:"5f633e47",8142:"5edfc34d",8249:"a2dd33e2",8401:"0d444abe",8565:"b7153d5a",8756:"704db1d5",9026:"7626c69e",9032:"67a3e002",9048:"fa9eaf65",9172:"f5bfbf12",9412:"d4dba7ab",9510:"81e2df6a",9532:"2a31613f",9647:"d28d5273"}[e]+".js",f.miniCssF=e=>{},f.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),t={},o="openrag-docs:",f.l=(e,a,r,c)=>{if(t[e])t[e].push(a);else{var d,n;if(void 0!==r)for(var b=document.getElementsByTagName("script"),i=0;i<b.length;i++){var l=b[i];if(l.getAttribute("src")==e||l.getAttribute("data-webpack")==o+r){d=l;break}}d||(n=!0,(d=document.createElement("script")).charset="utf-8",f.nc&&d.setAttribute("nonce",f.nc),d.setAttribute("data-webpack",o+r),d.src=e),t[e]=[a];var u=(a,r)=>{d.onerror=d.onload=null,clearTimeout(s);var o=t[e];if(delete t[e],d.parentNode&&d.parentNode.removeChild(d),o&&o.forEach(e=>e(r)),a)return a(r)},s=setTimeout(u.bind(null,void 0,{type:"timeout",target:d}),12e4);d.onerror=u.bind(null,d.onerror),d.onload=u.bind(null,d.onload),n&&document.head.appendChild(d)}},f.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},f.p="/",f.gca=function(e){return e={17896441:"8401",33362219:"9532",af920ffe:"98","0ba6a408":"571","22dd74f7":"1567",common:"2076","749371cc":"2272",eb5b356a:"2668","27b4a875":"3207","71478a5d":"5490",aba21aa0:"5742",d0314b07:"5750",ca2c3c0c:"6919",a7bd4aaa:"7098",c8078f0a:"9026",a94703ab:"9048",e633a5ea:"9172","5e95c892":"9647"}[e]||e,f.p+f.u(e)},(()=>{var e={5354:0,1869:0};f.f.j=(a,r)=>{var t=f.o(e,a)?e[a]:void 0;if(0!==t)if(t)r.push(t[2]);else if(/^(1869|5354)$/.test(a))e[a]=0;else{var o=new Promise((r,o)=>t=e[a]=[r,o]);r.push(t[2]=o);var c=f.p+f.u(a),d=new Error;f.l(c,r=>{if(f.o(e,a)&&(0!==(t=e[a])&&(e[a]=void 0),t)){var o=r&&("load"===r.type?"missing":r.type),c=r&&r.target&&r.target.src;d.message="Loading chunk "+a+" failed.\n("+o+": "+c+")",d.name="ChunkLoadError",d.type=o,d.request=c,t[1](d)}},"chunk-"+a,a)}},f.O.j=a=>0===e[a];var a=(a,r)=>{var t,o,[c,d,n]=r,b=0;if(c.some(a=>0!==e[a])){for(t in d)f.o(d,t)&&(f.m[t]=d[t]);if(n)var i=n(f)}for(a&&a(r);b<c.length;b++)o=c[b],f.o(e,o)&&e[o]&&e[o][0](),e[o]=0;return f.O(i)},r=globalThis.webpackChunkopenrag_docs=globalThis.webpackChunkopenrag_docs||[];r.forEach(a.bind(null,0)),r.push=a.bind(null,r.push.bind(r))})()})();
(()=>{"use strict";var e,a,r,t,o,c={},d={};function f(e){var a=d[e];if(void 0!==a)return a.exports;var r=d[e]={id:e,loaded:!1,exports:{}};return c[e].call(r.exports,r,r.exports,f),r.loaded=!0,r.exports}f.m=c,f.c=d,e=[],f.O=(a,r,t,o)=>{if(!r){var c=1/0;for(i=0;i<e.length;i++){for(var[r,t,o]=e[i],d=!0,n=0;n<r.length;n++)(!1&o||c>=o)&&Object.keys(f.O).every(e=>f.O[e](r[n]))?r.splice(n--,1):(d=!1,o<c&&(c=o));if(d){e.splice(i--,1);var b=t();void 0!==b&&(a=b)}}return a}o=o||0;for(var i=e.length;i>0&&e[i-1][2]>o;i--)e[i]=e[i-1];e[i]=[r,t,o]},f.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return f.d(a,{a:a}),a},r=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,f.t=function(e,t){if(1&t&&(e=this(e)),8&t)return e;if("object"==typeof e&&e){if(4&t&&e.__esModule)return e;if(16&t&&"function"==typeof e.then)return e}var o=Object.create(null);f.r(o);var c={};a=a||[null,r({}),r([]),r(r)];for(var d=2&t&&e;("object"==typeof d||"function"==typeof d)&&!~a.indexOf(d);d=r(d))Object.getOwnPropertyNames(d).forEach(a=>c[a]=()=>e[a]);return c.default=()=>e,f.d(o,c),o},f.d=(e,a)=>{for(var r in a)f.o(a,r)&&!f.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:a[r]})},f.f={},f.e=e=>Promise.all(Object.keys(f.f).reduce((a,r)=>(f.f[r](e,a),a),[])),f.u=e=>"assets/js/"+({98:"af920ffe",571:"0ba6a408",1567:"22dd74f7",2076:"common",2272:"749371cc",2668:"eb5b356a",3207:"27b4a875",5490:"71478a5d",5742:"aba21aa0",5750:"d0314b07",6919:"ca2c3c0c",7098:"a7bd4aaa",8401:"17896441",9026:"c8078f0a",9048:"a94703ab",9172:"e633a5ea",9532:"33362219",9647:"5e95c892"}[e]||e)+"."+{98:"f3ba20bd",165:"7b1d067d",291:"1b64972f",571:"eddb3e7e",617:"e8fa27b8",1e3:"f9af7a41",1203:"b618bb61",1567:"bcf46a1b",1741:"b927934f",1746:"c8a2211b",2076:"6bf331d5",2130:"09232a19",2237:"70c48bab",2272:"7bf165c7",2279:"12a16213",2291:"2c483c10",2325:"7c4239a7",2334:"daa16321",2492:"e6c78669",2668:"285e3b8b",2821:"e806cb03",3207:"8de9f81c",3490:"026802f4",3815:"f87fc96a",4250:"77e8e6c6",4616:"b519f330",4802:"a8b2857c",4981:"61cf4b0a",5480:"cd9ee90b",5490:"57b0036a",5742:"2f625fe1",5750:"26db9c14",5901:"f6ccb00b",5955:"14464ff3",5996:"16c59d9f",6241:"11caa48e",6319:"4754ec94",6366:"0c77f825",6567:"b1623b8d",6919:"7114a4c2",6992:"3c4d161b",7098:"9fea9356",7465:"7e0b8008",7592:"d6165eff",7873:"547873d3",7928:"5f633e47",8142:"5edfc34d",8249:"a2dd33e2",8401:"0d444abe",8565:"b7153d5a",8756:"704db1d5",9026:"7626c69e",9032:"67a3e002",9048:"fa9eaf65",9172:"f5bfbf12",9412:"d4dba7ab",9510:"81e2df6a",9532:"2a31613f",9647:"d28d5273"}[e]+".js",f.miniCssF=e=>{},f.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),t={},o="openrag-docs:",f.l=(e,a,r,c)=>{if(t[e])t[e].push(a);else{var d,n;if(void 0!==r)for(var b=document.getElementsByTagName("script"),i=0;i<b.length;i++){var l=b[i];if(l.getAttribute("src")==e||l.getAttribute("data-webpack")==o+r){d=l;break}}d||(n=!0,(d=document.createElement("script")).charset="utf-8",f.nc&&d.setAttribute("nonce",f.nc),d.setAttribute("data-webpack",o+r),d.src=e),t[e]=[a];var u=(a,r)=>{d.onerror=d.onload=null,clearTimeout(s);var o=t[e];if(delete t[e],d.parentNode&&d.parentNode.removeChild(d),o&&o.forEach(e=>e(r)),a)return a(r)},s=setTimeout(u.bind(null,void 0,{type:"timeout",target:d}),12e4);d.onerror=u.bind(null,d.onerror),d.onload=u.bind(null,d.onload),n&&document.head.appendChild(d)}},f.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},f.p="/",f.gca=function(e){return e={17896441:"8401",33362219:"9532",af920ffe:"98","0ba6a408":"571","22dd74f7":"1567",common:"2076","749371cc":"2272",eb5b356a:"2668","27b4a875":"3207","71478a5d":"5490",aba21aa0:"5742",d0314b07:"5750",ca2c3c0c:"6919",a7bd4aaa:"7098",c8078f0a:"9026",a94703ab:"9048",e633a5ea:"9172","5e95c892":"9647"}[e]||e,f.p+f.u(e)},(()=>{var e={5354:0,1869:0};f.f.j=(a,r)=>{var t=f.o(e,a)?e[a]:void 0;if(0!==t)if(t)r.push(t[2]);else if(/^(1869|5354)$/.test(a))e[a]=0;else{var o=new Promise((r,o)=>t=e[a]=[r,o]);r.push(t[2]=o);var c=f.p+f.u(a),d=new Error;f.l(c,r=>{if(f.o(e,a)&&(0!==(t=e[a])&&(e[a]=void 0),t)){var o=r&&("load"===r.type?"missing":r.type),c=r&&r.target&&r.target.src;d.message="Loading chunk "+a+" failed.\n("+o+": "+c+")",d.name="ChunkLoadError",d.type=o,d.request=c,t[1](d)}},"chunk-"+a,a)}},f.O.j=a=>0===e[a];var a=(a,r)=>{var t,o,[c,d,n]=r,b=0;if(c.some(a=>0!==e[a])){for(t in d)f.o(d,t)&&(f.m[t]=d[t]);if(n)var i=n(f)}for(a&&a(r);b<c.length;b++)o=c[b],f.o(e,o)&&e[o]&&e[o][0](),e[o]=0;return f.O(i)},r=globalThis.webpackChunkopenrag_docs=globalThis.webpackChunkopenrag_docs||[];r.forEach(a.bind(null,0)),r.push=a.bind(null,r.push.bind(r))})()})();

14
chat/index.html
View file

File diff suppressed because one or more lines are too long

144
docker/index.html
View file

@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">Install OpenRAG containers | OpenRAG</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="robots" content="noindex, nofollow"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openr.ag/docker"><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="Install OpenRAG containers | OpenRAG"><meta data-rh="true" name="description" content="OpenRAG has two Docker Compose files. Both files deploy the same applications and containers locally, but they are for different environments:"><meta data-rh="true" property="og:description" content="OpenRAG has two Docker Compose files. Both files deploy the same applications and containers locally, but they are for different environments:"><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.openr.ag/docker"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/docker" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/docker" hreflang="x-default"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Install OpenRAG containers","item":"https://docs.openr.ag/docker"}]}</script><link rel="stylesheet" href="/assets/css/styles.66669ecc.css">
<script src="/assets/js/runtime~main.f46e5be3.js" defer="defer"></script>
<script src="/assets/js/runtime~main.a3cb74e9.js" defer="defer"></script>
<script src="/assets/js/main.86159c47.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">
@ -213,15 +213,141 @@ These commands are also available in the TUI&#x27;s <a class="" href="/install#s
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="upgrade-containers">Upgrade containers<a href="#upgrade-containers" class="hash-link" aria-label="Direct link to Upgrade containers" title="Direct link to Upgrade containers" translate="no">​</a></h3>
<p>Upgrade your containers to the latest version while preserving your data.</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker compose pull</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">docker compose up -d --force-recreate</span><br></span></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="rebuild-containers-destructive">Rebuild containers (destructive)<a href="#rebuild-containers-destructive" class="hash-link" aria-label="Direct link to Rebuild containers (destructive)" title="Direct link to Rebuild containers (destructive)" translate="no">​</a></h3>
<p>Reset state by rebuilding all of your containers.
Your OpenSearch and Langflow databases will be lost.
Documents stored in the <code>./openrag-documents</code> directory will persist, since the directory is mounted as a volume in the OpenRAG backend container.</p>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="reset-containers">Reset containers (destructive)<a href="#reset-containers" class="hash-link" aria-label="Direct link to Reset containers (destructive)" title="Direct link to Reset containers (destructive)" translate="no">​</a></h3>
<div class="theme-admonition theme-admonition-warning admonition_xJq3 alert alert--warning"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 16 16"><path fill-rule="evenodd" d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>warning</div><div class="admonitionContent_BuS1"><p>These are destructive operations that reset your OpenRAG deployment to an initial state.
Be aware that data is lost and cannot be recovered after running these commands.</p></div></div>
<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">Docker Compose</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Podman Compose</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Docker</li><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Podman</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6"><ul>
<li class="">
<p>Rebuild containers: This command destroys and recreates the containers. Data stored exclusively on the containers is lost, such as Langflow flows.
The <code>.env</code> file, <code>config</code> directory, <code>./openrag-documents</code> directory, <code>./opensearch-data</code> directory, and the <code>conversations.json</code> file are preserved.</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker compose up --build --force-recreate --remove-orphans</span><br></span></code></pre></div></div>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="remove-all-containers-and-data-destructive">Remove all containers and data (destructive)<a href="#remove-all-containers-and-data-destructive" class="hash-link" aria-label="Direct link to Remove all containers and data (destructive)" title="Direct link to Remove all containers and data (destructive)" translate="no">​</a></h3>
<p>Completely remove your OpenRAG installation and delete all data.
This deletes all of your data, including OpenSearch data, uploaded documents, and authentication.</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker compose down --volumes --remove-orphans --rmi local</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">docker system prune -f</span><br></span></code></pre></div></div></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="row margin-top--sm theme-doc-footer-edit-meta-row"><div class="col noPrint_WFHX"><a href="https://github.com/openrag/openrag/tree/main/docs/docs/get-started/docker.mdx" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_JAkA"></div></div></footer></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/install"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Install OpenRAG with TUI</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/agents"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Flows</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="#prerequisites" class="table-of-contents__link toc-highlight">Prerequisites</a></li><li><a href="#install-openrag-with-docker-compose" class="table-of-contents__link toc-highlight">Install OpenRAG with Docker Compose</a></li><li><a href="#application-onboarding" class="table-of-contents__link toc-highlight">Application onboarding</a></li><li><a href="#container-management-commands" class="table-of-contents__link toc-highlight">Container management commands</a><ul><li><a href="#upgrade-containers" class="table-of-contents__link toc-highlight">Upgrade containers</a></li><li><a href="#rebuild-containers-destructive" class="table-of-contents__link toc-highlight">Rebuild containers (destructive)</a></li><li><a href="#remove-all-containers-and-data-destructive" class="table-of-contents__link toc-highlight">Remove all containers and data (destructive)</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">
</li>
<li class="">
<p>Destroy and recreate containers with the option for additional data removal: These commands destroy the containers, and then recreate them.
This allows you to delete other OpenRAG data before recreating the containers.</p>
<ol>
<li class="">
<p>Destroy the containers, volumes, and local images, and then remove (prune) any additional Docker objects:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker compose down --volumes --remove-orphans --rmi local</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">docker system prune -f</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Optional: Remove data that wasn&#x27;t deleted by the previous commands:</p>
<ul>
<li class="">OpenRAG&#x27;s <code>.env</code> file</li>
<li class="">The contents of OpenRAG&#x27;s <code>config</code> directory</li>
<li class="">The contents of the <code>./openrag-documents</code> directory</li>
<li class="">The contents of the <code>./opensearch-data</code> directory</li>
<li class="">The <code>conversations.json</code> file</li>
</ul>
</li>
<li class="">
<p>Recreate the containers:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker compose up -d</span><br></span></code></pre></div></div>
</li>
</ol>
</li>
</ul></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><ul>
<li class="">
<p>Rebuild containers: This command destroys and recreates the containers. Data stored exclusively on the containers is lost, such as Langflow flows.
The <code>.env</code> file, <code>config</code> directory, <code>./openrag-documents</code> directory, <code>./opensearch-data</code> directory, and the <code>conversations.json</code> file are preserved.</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman-compose up --build --force-recreate --remove-orphans</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Destroy and recreate containers with the option for additional data removal: These commands destroy the containers, and then recreate them.
This allows you to delete other OpenRAG data before recreating the containers.</p>
<ol>
<li class="">
<p>Destroy the containers, volumes, and local images, and then remove (prune) any additional Podman objects:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman-compose down --volumes --remove-orphans --rmi local</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">podman system prune -f</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Optional: Remove data that wasn&#x27;t deleted by the previous commands:</p>
<ul>
<li class="">OpenRAG&#x27;s <code>.env</code> file</li>
<li class="">The contents of OpenRAG&#x27;s <code>config</code> directory</li>
<li class="">The contents of the <code>./openrag-documents</code> directory</li>
<li class="">The contents of the <code>./opensearch-data</code> directory</li>
<li class="">The <code>conversations.json</code> file</li>
</ul>
</li>
<li class="">
<p>Recreate the containers:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman-compose up -d</span><br></span></code></pre></div></div>
</li>
</ol>
</li>
</ul></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><ol>
<li class="">
<p>Stop all running containers:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker stop $(docker ps -q)</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Remove all containers, including stopped containers:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker rm --force $(docker ps -aq)</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Remove all images:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker rmi --force $(docker images -q)</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Remove all volumes:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker volume prune --force</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Remove all networks except the default network:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker network prune --force</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Clean up any leftover data:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker system prune --all --force --volumes</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Optional: Remove data that wasn&#x27;t deleted by the previous commands:</p>
<ul>
<li class="">OpenRAG&#x27;s <code>.env</code> file</li>
<li class="">The contents of OpenRAG&#x27;s <code>config</code> directory</li>
<li class="">The contents of the <code>./openrag-documents</code> directory</li>
<li class="">The contents of the <code>./opensearch-data</code> directory</li>
<li class="">The <code>conversations.json</code> file</li>
</ul>
</li>
</ol></div><div role="tabpanel" class="tabItem_Ymn6" hidden=""><ol>
<li class="">
<p>Stop all running containers:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman stop --all</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Remove all containers, including stopped containers:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman rm --all --force</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Remove all images:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman rmi --all --force</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Remove all volumes:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman volume prune --force</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Remove all networks except the default network:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman network prune --force</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Clean up any leftover data:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman system prune --all --force --volumes</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Optional: Remove data that wasn&#x27;t deleted by the previous commands:</p>
<ul>
<li class="">OpenRAG&#x27;s <code>.env</code> file</li>
<li class="">The contents of OpenRAG&#x27;s <code>config</code> directory</li>
<li class="">The contents of the <code>./openrag-documents</code> directory</li>
<li class="">The contents of the <code>./opensearch-data</code> directory</li>
<li class="">The <code>conversations.json</code> file</li>
</ul>
</li>
</ol></div></div></div>
<p>After resetting your containers, you must repeat <a href="#application-onboarding" class="">application onboarding</a>.</p></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="row margin-top--sm theme-doc-footer-edit-meta-row"><div class="col noPrint_WFHX"><a href="https://github.com/openrag/openrag/tree/main/docs/docs/get-started/docker.mdx" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_JAkA"></div></div></footer></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/install"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Install OpenRAG with TUI</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/agents"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Flows</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="#prerequisites" class="table-of-contents__link toc-highlight">Prerequisites</a></li><li><a href="#install-openrag-with-docker-compose" class="table-of-contents__link toc-highlight">Install OpenRAG with Docker Compose</a></li><li><a href="#application-onboarding" class="table-of-contents__link toc-highlight">Application onboarding</a></li><li><a href="#container-management-commands" class="table-of-contents__link toc-highlight">Container management commands</a><ul><li><a href="#upgrade-containers" class="table-of-contents__link toc-highlight">Upgrade containers</a></li><li><a href="#reset-containers" class="table-of-contents__link toc-highlight">Reset containers (destructive)</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>© 2025 OpenRAG</span>
</div></li></ul></div></div></div></footer></div>
</body>

2
index.html
View file

@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">What is OpenRAG? | OpenRAG</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="robots" content="noindex, nofollow"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openr.ag/"><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="What is OpenRAG? | OpenRAG"><meta data-rh="true" name="description" content="OpenRAG is an open-source package for building agentic RAG systems that integrates with a wide range of orchestration tools, vector databases, and LLM providers."><meta data-rh="true" property="og:description" content="OpenRAG is an open-source package for building agentic RAG systems that integrates with a wide range of orchestration tools, vector databases, and LLM providers."><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.openr.ag/"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/" hreflang="x-default"><script data-rh="true">function insertBanner(){var n=document.createElement("div");n.id="__docusaurus-base-url-issue-banner-container";n.innerHTML='\n<div id="__docusaurus-base-url-issue-banner" style="border: thick solid red; background-color: rgb(255, 230, 179); margin: 20px; padding: 20px; font-size: 20px;">\n <p style="font-weight: bold; font-size: 30px;">Your Docusaurus site did not load properly.</p>\n <p>A very common reason is a wrong site <a href="https://docusaurus.io/docs/docusaurus.config.js/#baseUrl" style="font-weight: bold;">baseUrl configuration</a>.</p>\n <p>Current configured baseUrl = <span style="font-weight: bold; color: red;">/</span> (default value)</p>\n <p>We suggest trying baseUrl = <span id="__docusaurus-base-url-issue-banner-suggestion-container" style="font-weight: bold; color: green;"></span></p>\n</div>\n',document.body.prepend(n);var e=document.getElementById("__docusaurus-base-url-issue-banner-suggestion-container"),s=window.location.pathname,o="/"===s.substr(-1)?s:s+"/";e.innerHTML=o}document.addEventListener("DOMContentLoaded",function(){void 0===window.docusaurus&&insertBanner()})</script><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"About OpenRAG","item":"https://docs.openr.ag/"}]}</script><link rel="stylesheet" href="/assets/css/styles.66669ecc.css">
<script src="/assets/js/runtime~main.f46e5be3.js" defer="defer"></script>
<script src="/assets/js/runtime~main.a3cb74e9.js" defer="defer"></script>
<script src="/assets/js/main.86159c47.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">

4
ingestion/index.html
View file

@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">Ingest knowledge | OpenRAG</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="robots" content="noindex, nofollow"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openr.ag/ingestion"><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="Ingest knowledge | OpenRAG"><meta data-rh="true" name="description" content="Upload documents to your OpenRAG OpenSearch instance to populate your knowledge base with unique content, such as your own company documents, research papers, or websites."><meta data-rh="true" property="og:description" content="Upload documents to your OpenRAG OpenSearch instance to populate your knowledge base with unique content, such as your own company documents, research papers, or websites."><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.openr.ag/ingestion"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/ingestion" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/ingestion" hreflang="x-default"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Ingest knowledge","item":"https://docs.openr.ag/ingestion"}]}</script><link rel="stylesheet" href="/assets/css/styles.66669ecc.css">
<script src="/assets/js/runtime~main.f46e5be3.js" defer="defer"></script>
<script src="/assets/js/runtime~main.a3cb74e9.js" defer="defer"></script>
<script src="/assets/js/main.86159c47.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">
@ -265,7 +265,7 @@ All errors were file-specific, and they didn&#x27;t stop the pipeline.</p>
<li class="">Split excessively large files into smaller files before uploading.</li>
<li class="">Remove unusual embedded content, such as videos or animations, before uploading. Although Docling can replace some non-text content with placeholders during ingestion, some embedded content might cause errors.</li>
</ul>
<p>If the OpenRAG <strong>Chat</strong> doesn&#x27;t seem to use your documents correctly, <a href="#browse-knowledge" class="">browse your knowledge base</a> to confirm that the documents are uploaded in full, and the chunks are correct.</p>
<p>If the OpenRAG <strong>Chat</strong> doesn&#x27;t seem to use your documents correctly, <a class="" href="/knowledge#browse-knowledge">browse your knowledge base</a> to confirm that the documents are uploaded in full, and the chunks are correct.</p>
<p>If the documents are present and well-formed, check your <a class="" href="/knowledge-filters">knowledge filters</a>.
If a global filter is applied, make sure the expected documents are included in the global filter.
If the global filter excludes any documents, the agent cannot access those documents unless you apply a chat-level filter or change the global filter.</p>

73
install/index.html
View file

@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">Install OpenRAG with TUI | OpenRAG</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="robots" content="noindex, nofollow"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openr.ag/install"><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="Install OpenRAG with TUI | OpenRAG"><meta data-rh="true" name="description" content="Install OpenRAG and then run the OpenRAG Terminal User Interface(TUI) to start your OpenRAG deployment with a guided setup process."><meta data-rh="true" property="og:description" content="Install OpenRAG and then run the OpenRAG Terminal User Interface(TUI) to start your OpenRAG deployment with a guided setup process."><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.openr.ag/install"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/install" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/install" hreflang="x-default"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Install OpenRAG with TUI","item":"https://docs.openr.ag/install"}]}</script><link rel="stylesheet" href="/assets/css/styles.66669ecc.css">
<script src="/assets/js/runtime~main.f46e5be3.js" defer="defer"></script>
<script src="/assets/js/runtime~main.a3cb74e9.js" defer="defer"></script>
<script src="/assets/js/main.86159c47.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">
@ -337,23 +337,35 @@ To copy the logs, click <strong>Copy to Clipboard</strong>.</p>
<p><strong>Upgrade</strong>: Check for updates. For more information, see <a href="#upgrade" class="">upgrade OpenRAG</a>.</p>
</li>
<li class="">
<p><strong>Reset</strong>: This is a destructive action that <a href="#reset-containers" class="">resets your containers</a>.</p>
<p><strong>Factory Reset</strong>: This is a destructive action that <a href="#reset-containers" class="">resets your containers</a>.</p>
</li>
<li class="">
<p><strong>Native services</strong>: From the <strong>Status</strong> menu, you can view the status, port, and process ID (PID) of the OpenRAG native services.
You can also click <strong>Stop</strong> or <strong>Restart</strong> to stop and start OpenRAG native services.</p>
<p>A <em>native service</em> in OpenRAG is a service that runs locally on your machine, not within a container. For example, the <code>docling serve</code> process is an OpenRAG native service because this document processing service runs on your local machine, separate from the OpenRAG containers.</p>
<p><strong>Native services</strong>: <a href="#start-all-services" class="">View and manage OpenRAG services</a> that run directly on your local machine instead of a container.</p>
</li>
</ul>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="reset-containers">Reset containers<a href="#reset-containers" class="hash-link" aria-label="Direct link to Reset containers" title="Direct link to Reset containers" translate="no">​</a></h3>
<div class="theme-admonition theme-admonition-warning admonition_xJq3 alert alert--warning"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 16 16"><path fill-rule="evenodd" d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>warning</div><div class="admonitionContent_BuS1"><p>This is a destructive action that destroys and recreates all of your OpenRAG containers.</p></div></div>
<p>To destroy and recreate your OpenRAG containers, go to the TUI <a href="#status" class=""><strong>Status</strong> menu</a>, and then click <strong>Reset</strong>.</p>
<p>The <strong>Reset</strong> function runs two commands. First, it stops and removes all containers, volumes, and local images:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker compose down --volumes --remove-orphans --rmi local</span><br></span></code></pre></div></div>
<p>Then, it removes any additional Docker objects with <code>docker system prune -f</code>.</p>
<p>If you reset your containers as part of reinstalling OpenRAG, continue the <a href="#reinstall" class="">reinstallation process</a> after resetting the containers.</p>
<p>Reset your OpenRAG deployment by recreating the containers and removing some related data.</p>
<div class="theme-admonition theme-admonition-warning admonition_xJq3 alert alert--warning"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 16 16"><path fill-rule="evenodd" d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>warning</div><div class="admonitionContent_BuS1"><p>This is a destructive action that destroys the following:</p><ul>
<li class="">All OpenRAG containers, volumes, and local images</li>
<li class="">Any additional Docker objects</li>
<li class="">The contents of OpenRAG&#x27;s <code>config</code> and <code>./opensearch-data</code> directories</li>
<li class="">The <code>conversations.json</code> file</li>
</ul><p>This operation <em>doesn&#x27;t</em> remove the <code>.env</code> file or the contents of the <code>./openrag-documents</code> directory.</p></div></div>
<ol>
<li class="">
<p>To destroy and recreate your OpenRAG containers, go to the TUI <a href="#status" class=""><strong>Status</strong> menu</a>, and then click <strong>Factory Reset</strong>.</p>
<p>This function runs the following commands <em>and</em> deletes the contents of OpenRAG&#x27;s <code>config</code> and <code>./opensearch-data</code> directories.</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker compose down --volumes --remove-orphans --rmi local</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">docker system prune -f</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>If you reset your containers as part of reinstalling OpenRAG, continue the <a href="#reinstall" class="">reinstallation process</a> after resetting the containers.
Otherwise, in the TUI <strong>Setup</strong> menu, repeat the <a href="#setup" class="">setup process</a> to start the services and launch the OpenRAG app. Your OpenRAG passwords, OAuth credentials (if previously set), and onboarding configuration are restored from the <code>.env</code> file.</p>
</li>
</ol>
<h3 class="anchor anchorTargetStickyNavbar_Vzrq" id="start-all-services">Start all services<a href="#start-all-services" class="hash-link" aria-label="Direct link to Start all services" title="Direct link to Start all services" translate="no">​</a></h3>
<p>On the TUI main page, click <strong>Start All Services</strong> to start the OpenRAG containers and launch OpenRAG itself.</p>
<p>Through the TUI, you can view and manage OpenRAG services that run in containers and directly on your local machine.</p>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="start-containers">Start containers<a href="#start-containers" class="hash-link" aria-label="Direct link to Start containers" title="Direct link to Start containers" translate="no">​</a></h4>
<p>On the TUI main page or the <strong>Setup</strong> menu, click <strong>Start All Services</strong> to start the OpenRAG containers and launch OpenRAG itself.</p>
<p>When you start all services, the following processes happen:</p>
<ol>
<li class="">
@ -366,6 +378,10 @@ You can also click <strong>Stop</strong> or <strong>Restart</strong> to stop and
<p>OpenRAG deploys the containers with <code>docker compose up -d</code>.</p>
</li>
</ol>
<h4 class="anchor anchorTargetStickyNavbar_Vzrq" id="start-native-services-docling">Start native services (Docling)<a href="#start-native-services-docling" class="hash-link" aria-label="Direct link to Start native services (Docling)" title="Direct link to Start native services (Docling)" translate="no">​</a></h4>
<p>A <em>native service</em> in OpenRAG is a service that runs locally on your machine, not within a container. For example, the <code>docling serve</code> process is an OpenRAG native service because this document processing service runs on your local machine, separate from the OpenRAG containers.</p>
<p>From the <strong>Status</strong> menu, you can view the status, port, and process ID (PID) of the OpenRAG native services.
You can also click <strong>Stop</strong> or <strong>Restart</strong> to stop and start OpenRAG native services.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="upgrade">Upgrade OpenRAG<a href="#upgrade" class="hash-link" aria-label="Direct link to Upgrade OpenRAG" title="Direct link to Upgrade OpenRAG" translate="no">​</a></h2>
<p>To upgrade OpenRAG, upgrade the OpenRAG Python package, and then upgrade the OpenRAG containers.</p>
<p>This is a two part process because upgrading the OpenRAG Python package updates the TUI and Python code, but the container versions are controlled by environment variables in your <code>.env</code> file.</p>
@ -432,30 +448,29 @@ The TUI warns you if it detects a version mismatch.</p>
</li>
</ol>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="reinstall">Reinstall OpenRAG<a href="#reinstall" class="hash-link" aria-label="Direct link to Reinstall OpenRAG" title="Direct link to Reinstall OpenRAG" translate="no">​</a></h2>
<p>To reinstall OpenRAG with a completely fresh setup:</p>
<p>Reset your OpenRAG deployment by recreating the containers and, optionally, removing related data:</p>
<ol>
<li class="">
<p>In the TUI <strong>Status</strong> menu, <a href="#reset-containers" class="">reset your containers</a> to destroy the existing OpenRAG containers and their data.</p>
<p>In the TUI, <a href="#reset-containers" class="">reset your containers</a> to destroy the following:</p>
<ul>
<li class="">All existing OpenRAG containers, volumes, and local images</li>
<li class="">Any additional Docker objects</li>
<li class="">The contents of OpenRAG&#x27;s <code>config</code> and <code>./opensearch-data</code> directories</li>
<li class="">The <code>conversations.json</code> file</li>
</ul>
</li>
<li class="">
<p>Optional: Delete your project&#x27;s <code>.env</code> file.</p>
<p>The Reset operation doesn&#x27;t remove your project&#x27;s <code>.env</code> file, so your passwords, API keys, and OAuth settings can be preserved.
If you delete the <code>.env</code> file, you must run the <a href="#setup" class="">Set up OpenRAG with the TUI</a> process again to create a new configuration file.</p>
<p>Optional: Remove data that wasn&#x27;t deleted by the <strong>Factory Reset</strong> operation. For a completely fresh installation, delete all of this data.</p>
<ul>
<li class=""><strong>OpenRAG&#x27;s <code>.env</code> file</strong>: Contains your OpenRAG configuration, including OpenRAG passwords, API keys, OAuth settings, and other <a class="" href="/reference/configuration">environment variables</a>. If you delete this file, you must either repeat the <a href="#setup" class="">setup process</a> to create a new <code>.env</code> file, or add a populated <code>.env</code> file to your OpenRAG installation directory before restarting OpenRAG.</li>
<li class=""><strong>The contents of the <code>./openrag-documents</code> directory</strong>: Contains documents that you uploaded to OpenRAG. Delete these files to prevent documents from being reingested to your knowledge base after restarting OpenRAG. However, you might want to preserve OpenRAG&#x27;s <a href="https://github.com/langflow-ai/openrag/tree/main/openrag-documents" target="_blank" rel="noopener noreferrer" class="">default documents</a>.</li>
</ul>
</li>
<li class="">
<p>Optional: Delete your OpenSearch knowledge base by deleting the contents of the <code>./opensearch-data</code> folder in your OpenRAG installation directory.</p>
<p>In the TUI <strong>Setup</strong> menu, repeat the <a href="#setup" class="">setup process</a> to configure OpenRAG, restart the services, and launch the OpenRAG app, and repeat <a href="#application-onboarding" class="">application onboarding</a>.
If OpenRAG detects a <code>.env</code> file, it automatically populates any OpenRAG passwords, OAuth credentials, and onboarding configuration set in that file.</p>
</li>
<li class="">
<p>In the TUI <strong>Setup</strong> menu, repeat the <a href="#setup" class="">Basic Setup</a> process:</p>
<ol>
<li class="">Click <strong>Start All Services</strong> to pull container images and start them.</li>
<li class="">Under <strong>Native Services</strong>, click <strong>Start</strong> to start the Docling service.</li>
<li class="">Click <strong>Open App</strong> to open the OpenRAG application.</li>
<li class="">Continue with <a href="#application-onboarding" class="">application onboarding</a>.</li>
</ol>
</li>
</ol>
<p>If reinstalling OpenRAG and deleting the <code>.env</code> file doesn&#x27;t reset setup or onboarding, see <a class="" href="/support/troubleshoot#reinstalling-openrag-doesnt-reset-onboarding">Reinstalling OpenRAG doesn&#x27;t reset onboarding</a>.</p></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="row margin-top--sm theme-doc-footer-edit-meta-row"><div class="col noPrint_WFHX"><a href="https://github.com/openrag/openrag/tree/main/docs/docs/get-started/install.mdx" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_JAkA"></div></div></footer></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/quickstart"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Quickstart</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docker"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Install OpenRAG containers</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="#prerequisites" class="table-of-contents__link toc-highlight">Prerequisites</a></li><li><a href="#install" class="table-of-contents__link toc-highlight">Install OpenRAG</a></li><li><a href="#setup" class="table-of-contents__link toc-highlight">Set up OpenRAG with the TUI</a></li><li><a href="#application-onboarding" class="table-of-contents__link toc-highlight">Application onboarding</a></li><li><a href="#exit-the-openrag-tui" class="table-of-contents__link toc-highlight">Exit the OpenRAG TUI</a></li><li><a href="#tui-container-management" class="table-of-contents__link toc-highlight">Manage OpenRAG containers with the TUI</a><ul><li><a href="#diagnostics" class="table-of-contents__link toc-highlight">Diagnostics</a></li><li><a href="#status" class="table-of-contents__link toc-highlight">Status</a></li><li><a href="#reset-containers" class="table-of-contents__link toc-highlight">Reset containers</a></li><li><a href="#start-all-services" class="table-of-contents__link toc-highlight">Start all services</a></li></ul></li><li><a href="#upgrade" class="table-of-contents__link toc-highlight">Upgrade OpenRAG</a></li><li><a href="#reinstall" class="table-of-contents__link toc-highlight">Reinstall OpenRAG</a></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">
</ol></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="row margin-top--sm theme-doc-footer-edit-meta-row"><div class="col noPrint_WFHX"><a href="https://github.com/openrag/openrag/tree/main/docs/docs/get-started/install.mdx" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_JAkA"></div></div></footer></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/quickstart"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Quickstart</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docker"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Install OpenRAG containers</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="#prerequisites" class="table-of-contents__link toc-highlight">Prerequisites</a></li><li><a href="#install" class="table-of-contents__link toc-highlight">Install OpenRAG</a></li><li><a href="#setup" class="table-of-contents__link toc-highlight">Set up OpenRAG with the TUI</a></li><li><a href="#application-onboarding" class="table-of-contents__link toc-highlight">Application onboarding</a></li><li><a href="#exit-the-openrag-tui" class="table-of-contents__link toc-highlight">Exit the OpenRAG TUI</a></li><li><a href="#tui-container-management" class="table-of-contents__link toc-highlight">Manage OpenRAG containers with the TUI</a><ul><li><a href="#diagnostics" class="table-of-contents__link toc-highlight">Diagnostics</a></li><li><a href="#status" class="table-of-contents__link toc-highlight">Status</a></li><li><a href="#reset-containers" class="table-of-contents__link toc-highlight">Reset containers</a></li><li><a href="#start-all-services" class="table-of-contents__link toc-highlight">Start all services</a></li></ul></li><li><a href="#upgrade" class="table-of-contents__link toc-highlight">Upgrade OpenRAG</a></li><li><a href="#reinstall" class="table-of-contents__link toc-highlight">Reinstall OpenRAG</a></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>© 2025 OpenRAG</span>
</div></li></ul></div></div></div></footer></div>
</body>

10
knowledge-filters/index.html
View file

@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">Filter knowledge | OpenRAG</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="robots" content="noindex, nofollow"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openr.ag/knowledge-filters"><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="Filter knowledge | OpenRAG"><meta data-rh="true" name="description" content="OpenRAG&#x27;s knowledge filters help you organize and manage your knowledge base by creating pre-defined views of your documents."><meta data-rh="true" property="og:description" content="OpenRAG&#x27;s knowledge filters help you organize and manage your knowledge base by creating pre-defined views of your documents."><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.openr.ag/knowledge-filters"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/knowledge-filters" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/knowledge-filters" hreflang="x-default"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Filter knowledge","item":"https://docs.openr.ag/knowledge-filters"}]}</script><link rel="stylesheet" href="/assets/css/styles.66669ecc.css">
<script src="/assets/js/runtime~main.f46e5be3.js" defer="defer"></script>
<script src="/assets/js/runtime~main.a3cb74e9.js" defer="defer"></script>
<script src="/assets/js/main.86159c47.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">
@ -15,6 +15,12 @@
<p>Each knowledge filter captures a specific subset of documents based on given a search query and filters.</p>
<p>Knowledge filters can be used with different OpenRAG functionality.
For example, knowledge filters can help agents access large knowledge bases efficiently by narrowing the scope of documents that you want the agent to use.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="built-in-filters">Built-in filters<a href="#built-in-filters" class="hash-link" aria-label="Direct link to Built-in filters" title="Direct link to Built-in filters" translate="no">​</a></h2>
<p>When you install OpenRAG, it automatically creates an <strong>OpenRAG docs</strong> filter that includes OpenRAG&#x27;s default documents.
These documents provide information about OpenRAG itself and help you learn how to use OpenRAG.</p>
<p>When you use the OpenRAG <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-message-square" aria-hidden="true"><path d="M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z"></path></svg> <strong>Chat</strong>, <a href="#apply-a-filter" class="">apply the <strong>OpenRAG docs</strong> filter</a> if you want to ask questions about OpenRAG&#x27;s features and functionality.
This limits the agent&#x27;s context to the default OpenRAG documentation rather than all documents in your knowledge base.</p>
<p>After uploading your own documents, it is recommended that you create your own filters to organize your documents effectively and separate them from the default OpenRAG documents.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="create-a-filter">Create a filter<a href="#create-a-filter" class="hash-link" aria-label="Direct link to Create a filter" title="Direct link to Create a filter" translate="no">​</a></h2>
<p>To create a knowledge filter, do the following:</p>
<ol>
@ -63,7 +69,7 @@ Chat filters apply to one chat session only.</p>
<li class="">
<p>Click <strong>Delete Filter</strong>.</p>
</li>
</ol></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="row margin-top--sm theme-doc-footer-edit-meta-row"><div class="col noPrint_WFHX"><a href="https://github.com/openrag/openrag/tree/main/docs/docs/core-components/knowledge-filters.mdx" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_JAkA"></div></div></footer></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/ingestion"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Ingest knowledge</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/chat"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Chat</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="#create-a-filter" class="table-of-contents__link toc-highlight">Create a filter</a></li><li><a href="#apply-a-filter" class="table-of-contents__link toc-highlight">Apply a filter</a></li><li><a href="#delete-a-filter" class="table-of-contents__link toc-highlight">Delete a filter</a></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">
</ol></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="row margin-top--sm theme-doc-footer-edit-meta-row"><div class="col noPrint_WFHX"><a href="https://github.com/openrag/openrag/tree/main/docs/docs/core-components/knowledge-filters.mdx" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_JAkA"></div></div></footer></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/ingestion"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Ingest knowledge</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/chat"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Chat</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="#built-in-filters" class="table-of-contents__link toc-highlight">Built-in filters</a></li><li><a href="#create-a-filter" class="table-of-contents__link toc-highlight">Create a filter</a></li><li><a href="#apply-a-filter" class="table-of-contents__link toc-highlight">Apply a filter</a></li><li><a href="#delete-a-filter" class="table-of-contents__link toc-highlight">Delete a filter</a></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>© 2025 OpenRAG</span>
</div></li></ul></div></div></div></footer></div>
</body>

4
knowledge/index.html
View file

@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">Configure knowledge | OpenRAG</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="robots" content="noindex, nofollow"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openr.ag/knowledge"><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="Configure knowledge | OpenRAG"><meta data-rh="true" name="description" content="OpenRAG includes a built-in OpenSearch instance that serves as the underlying datastore for your knowledge (documents)."><meta data-rh="true" property="og:description" content="OpenRAG includes a built-in OpenSearch instance that serves as the underlying datastore for your knowledge (documents)."><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.openr.ag/knowledge"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/knowledge" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/knowledge" hreflang="x-default"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Configure knowledge","item":"https://docs.openr.ag/knowledge"}]}</script><link rel="stylesheet" href="/assets/css/styles.66669ecc.css">
<script src="/assets/js/runtime~main.f46e5be3.js" defer="defer"></script>
<script src="/assets/js/runtime~main.a3cb74e9.js" defer="defer"></script>
<script src="/assets/js/main.86159c47.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">
@ -22,7 +22,7 @@ Documents are processed through OpenRAG&#x27;s knowledge ingestion flows with Do
<p>The <strong>Knowledge</strong> page lists the documents OpenRAG has ingested into your OpenSearch database, specifically in an <a href="https://docs.opensearch.org/latest/getting-started/intro/#index" target="_blank" rel="noopener noreferrer" class="">OpenSearch index</a> named <code>documents</code>.</p>
<p>To explore the raw contents of your knowledge base, click <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-library" aria-hidden="true"><path d="m16 6 4 14"></path><path d="M12 6v14"></path><path d="M8 8v12"></path><path d="M4 4v16"></path></svg> <strong>Knowledge</strong> to get a list of all ingested documents.
Click a document to view the chunks produced from splitting the document during ingestion.</p>
<p>OpenRAG includes some initial documents about OpenRAG. You can use these documents to ask OpenRAG about itself, and to test the <a class="" href="/chat"><strong>Chat</strong></a> feature before uploading your own documents.
<p>By default, OpenRAG includes some initial documents about OpenRAG. You can use these documents to ask OpenRAG about itself, and to test the <a class="" href="/chat"><strong>Chat</strong></a> feature before uploading your own documents.
If you <a href="#delete-knowledge" class="">delete these documents</a>, you won&#x27;t be able to ask OpenRAG about itself and it&#x27;s own functionality.
It is recommended that you keep these documents, and use <a class="" href="/knowledge-filters">filters</a> to separate them from your other knowledge.</p>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="auth">OpenSearch authentication and document access<a href="#auth" class="hash-link" aria-label="Direct link to OpenSearch authentication and document access" title="Direct link to OpenSearch authentication and document access" translate="no">​</a></h2>

2
quickstart/index.html
View file

@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">Quickstart | OpenRAG</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="robots" content="noindex, nofollow"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openr.ag/quickstart"><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="Quickstart | OpenRAG"><meta data-rh="true" name="description" content="Use this quickstart to install OpenRAG, and then try some of OpenRAG&#x27;s core features."><meta data-rh="true" property="og:description" content="Use this quickstart to install OpenRAG, and then try some of OpenRAG&#x27;s core features."><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.openr.ag/quickstart"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/quickstart" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/quickstart" hreflang="x-default"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Quickstart","item":"https://docs.openr.ag/quickstart"}]}</script><link rel="stylesheet" href="/assets/css/styles.66669ecc.css">
<script src="/assets/js/runtime~main.f46e5be3.js" defer="defer"></script>
<script src="/assets/js/runtime~main.a3cb74e9.js" defer="defer"></script>
<script src="/assets/js/main.86159c47.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">

2
reference/configuration/index.html
View file

@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">Environment variables | OpenRAG</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="robots" content="noindex, nofollow"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openr.ag/reference/configuration"><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 | OpenRAG"><meta data-rh="true" name="description" content="OpenRAG recognizes environment variables from the following sources:"><meta data-rh="true" property="og:description" content="OpenRAG recognizes environment variables from the following sources:"><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.openr.ag/reference/configuration"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/reference/configuration" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/reference/configuration" hreflang="x-default"><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.openr.ag/reference/configuration"}]}</script><link rel="stylesheet" href="/assets/css/styles.66669ecc.css">
<script src="/assets/js/runtime~main.f46e5be3.js" defer="defer"></script>
<script src="/assets/js/runtime~main.a3cb74e9.js" defer="defer"></script>
<script src="/assets/js/main.86159c47.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">

75
support/troubleshoot/index.html
View file

@ -4,7 +4,7 @@
<meta charset="UTF-8">
<meta name="generator" content="Docusaurus v3.9.2">
<title data-rh="true">Troubleshoot OpenRAG | OpenRAG</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="robots" content="noindex, nofollow"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:url" content="https://docs.openr.ag/support/troubleshoot"><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="Troubleshoot OpenRAG | OpenRAG"><meta data-rh="true" name="description" content="This page provides troubleshooting advice for issues you might encounter when using OpenRAG or contributing to OpenRAG."><meta data-rh="true" property="og:description" content="This page provides troubleshooting advice for issues you might encounter when using OpenRAG or contributing to OpenRAG."><link data-rh="true" rel="icon" href="/img/favicon.ico"><link data-rh="true" rel="canonical" href="https://docs.openr.ag/support/troubleshoot"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/support/troubleshoot" hreflang="en"><link data-rh="true" rel="alternate" href="https://docs.openr.ag/support/troubleshoot" hreflang="x-default"><script data-rh="true" type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Troubleshoot OpenRAG","item":"https://docs.openr.ag/support/troubleshoot"}]}</script><link rel="stylesheet" href="/assets/css/styles.66669ecc.css">
<script src="/assets/js/runtime~main.f46e5be3.js" defer="defer"></script>
<script src="/assets/js/runtime~main.a3cb74e9.js" defer="defer"></script>
<script src="/assets/js/main.86159c47.js" defer="defer"></script>
</head>
<body class="navigation-with-keyboard">
@ -52,7 +52,9 @@ This example increases the machine size to 8 GB of RAM, which should be sufficie
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="langflow-container-already-exists-during-upgrade">Upgrade fails due to Langflow container already exists<a href="#langflow-container-already-exists-during-upgrade" class="hash-link" aria-label="Direct link to Upgrade fails due to Langflow container already exists" title="Direct link to Upgrade fails due to Langflow container already exists" translate="no">​</a></h2>
<p>If you encounter a <code>langflow container already exists</code> error when upgrading OpenRAG, this typically means you upgraded OpenRAG with <code>uv</code>, but you didn&#x27;t remove or upgrade containers from a previous installation.</p>
<p>To resolve this issue, do the following:</p>
<p>First, try removing only the Langflow container, and then retry the upgrade in the OpenRAG TUI by clicking <strong>Status</strong> and then <strong>Upgrade</strong>.</p>
<ol>
<li class="">
<p>Remove only the Langflow container:</p>
<div class="theme-tabs-container tabs-container tabList__CuJ"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Podman</li><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_LNqP tabs__item--active">Docker</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6" hidden=""><ol>
<li class="">
<p>Stop the Langflow container:</p>
@ -72,70 +74,27 @@ This example increases the machine size to 8 GB of RAM, which should be sufficie
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker rm langflow --force</span><br></span></code></pre></div></div>
</li>
</ol></div></div></div>
<p>If reinstalling the Langflow container doesn&#x27;t resolve the issue, you must reset to a fresh installation by removing all OpenRAG containers and data.
Then, you can retry the upgrade.</p>
<div class="theme-admonition theme-admonition-warning admonition_xJq3 alert alert--warning"><div class="admonitionHeading_Gvgb"><span class="admonitionIcon_Rf37"><svg viewBox="0 0 16 16"><path fill-rule="evenodd" d="M8.893 1.5c-.183-.31-.52-.5-.887-.5s-.703.19-.886.5L.138 13.499a.98.98 0 0 0 0 1.001c.193.31.53.501.886.501h13.964c.367 0 .704-.19.877-.5a1.03 1.03 0 0 0 .01-1.002L8.893 1.5zm.133 11.497H6.987v-2.003h2.039v2.003zm0-3.004H6.987V5.987h2.039v4.006z"></path></svg></span>warning</div><div class="admonitionContent_BuS1"><p>This is a destructive operation that destroys your OpenRAG containers and their contents.
However, your <code>.env</code> file (configuration settings) and <code>./opensearch-data</code> (OpenSearch knowledge base) are preserved.</p></div></div>
<p>To reset your installation, stop your containers, and then completely remove them.
After removing the containers, retry the upgrade in the OpenRAG TUI by clicking <strong>Status</strong> and then <strong>Upgrade</strong>.</p>
<div class="theme-tabs-container tabs-container tabList__CuJ"><ul role="tablist" aria-orientation="horizontal" class="tabs"><li role="tab" tabindex="-1" aria-selected="false" class="tabs__item tabItem_LNqP">Podman</li><li role="tab" tabindex="0" aria-selected="true" class="tabs__item tabItem_LNqP tabs__item--active">Docker</li></ul><div class="margin-top--md"><div role="tabpanel" class="tabItem_Ymn6" hidden=""><ol>
<li class="">
<p>Stop all running containers:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman stop --all</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Remove all containers, including stopped containers:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman rm --all --force</span><br></span></code></pre></div></div>
<p>Retry the upgrade:</p>
<ul>
<li class=""><a class="" href="/docker#upgrade-containers">Upgrade self-managed containers</a></li>
<li class=""><a class="" href="/install#upgrade-containers">Upgrade TUI-managed containers</a></li>
</ul>
</li>
<li class="">
<p>Remove all images:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman rmi --all --force</span><br></span></code></pre></div></div>
<p>If reinstalling the Langflow container doesn&#x27;t resolve the issue, you must reset your OpenRAG deployment:</p>
<ul>
<li class=""><a class="" href="/docker#reset-containers">Reset self-managed containers</a></li>
<li class=""><a class="" href="/install#reset-containers">Reset TUI-managed containers</a></li>
</ul>
</li>
<li class="">
<p>Remove all volumes:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman volume prune --force</span><br></span></code></pre></div></div>
<p>Retry the upgrade.</p>
</li>
<li class="">
<p>Remove all networks except the default network:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman network prune --force</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Clean up any leftover data:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">podman system prune --all --force --volumes</span><br></span></code></pre></div></div>
</li>
</ol></div><div role="tabpanel" class="tabItem_Ymn6"><ol>
<li class="">
<p>Stop all running containers:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker stop $(docker ps -q)</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Remove all containers, including stopped containers:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker rm --force $(docker ps -aq)</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Remove all images:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker rmi --force $(docker images -q)</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Remove all volumes:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker volume prune --force</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Remove all networks except the default network:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker network prune --force</span><br></span></code></pre></div></div>
</li>
<li class="">
<p>Clean up any leftover data:</p>
<div class="language-bash codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_QJqH"><pre tabindex="0" class="prism-code language-bash codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">docker system prune --all --force --volumes</span><br></span></code></pre></div></div>
</li>
</ol></div></div></div>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="reinstalling-openrag-doesnt-reset-onboarding">Reinstalling OpenRAG doesn&#x27;t reset onboarding<a href="#reinstalling-openrag-doesnt-reset-onboarding" class="hash-link" aria-label="Direct link to Reinstalling OpenRAG doesn&#x27;t reset onboarding" title="Direct link to Reinstalling OpenRAG doesn&#x27;t reset onboarding" translate="no">​</a></h2>
<p>If you <a class="" href="/install#reinstall">reinstall OpenRAG</a>, you can restore your installation to it&#x27;s original, default state by resetting the containers <em>and</em> deleting the <code>.env</code> file.</p>
<p>When you start OpenRAG after doing this, you should be prompted to go through the initial setup and onboarding process again.</p>
<p>Due to a known issue, the onboarding process might not reset when you reinstall OpenRAG.
If this occurs, <a class="" href="/install#install">install OpenRAG in a new Python project directory</a> (with <code>uv init</code> and <code>uv add openrag</code>).</p>
</ol>
<h2 class="anchor anchorTargetStickyNavbar_Vzrq" id="document-ingestion-or-similarity-search-issues">Document ingestion or similarity search issues<a href="#document-ingestion-or-similarity-search-issues" class="hash-link" aria-label="Direct link to Document ingestion or similarity search issues" title="Direct link to Document ingestion or similarity search issues" translate="no">​</a></h2>
<p>See <a class="" href="/ingestion#troubleshoot-ingestion">Troubleshoot ingestion</a>.</p></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="row margin-top--sm theme-doc-footer-edit-meta-row"><div class="col noPrint_WFHX"><a href="https://github.com/openrag/openrag/tree/main/docs/docs/support/troubleshoot.mdx" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_JAkA"></div></div></footer></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/reference/configuration"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Environment variables</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="#opensearch-fails-to-start" class="table-of-contents__link toc-highlight">OpenSearch fails to start</a></li><li><a href="#openrag-fails-to-start-from-the-tui-with-operation-not-supported" class="table-of-contents__link toc-highlight">OpenRAG fails to start from the TUI with operation not supported</a></li><li><a href="#openrag-installation-fails-with-unable-to-get-local-issuer-certificate" class="table-of-contents__link toc-highlight">OpenRAG installation fails with unable to get local issuer certificate</a></li><li><a href="#langflow-connection-issues" class="table-of-contents__link toc-highlight">Langflow connection issues</a></li><li><a href="#container-out-of-memory-errors" class="table-of-contents__link toc-highlight">Container out of memory errors</a></li><li><a href="#memory-issue-with-podman-on-macos" class="table-of-contents__link toc-highlight">Memory issue with Podman on macOS</a></li><li><a href="#port-conflicts" class="table-of-contents__link toc-highlight">Port conflicts</a></li><li><a href="#ocr-ingestion-fails-easyocr-not-installed" class="table-of-contents__link toc-highlight">OCR ingestion fails (easyocr not installed)</a></li><li><a href="#langflow-container-already-exists-during-upgrade" class="table-of-contents__link toc-highlight">Upgrade fails due to Langflow container already exists</a></li><li><a href="#reinstalling-openrag-doesnt-reset-onboarding" class="table-of-contents__link toc-highlight">Reinstalling OpenRAG doesn&#39;t reset onboarding</a></li><li><a href="#document-ingestion-or-similarity-search-issues" class="table-of-contents__link toc-highlight">Document ingestion or similarity search issues</a></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">
<p>See <a class="" href="/ingestion#troubleshoot-ingestion">Troubleshoot ingestion</a>.</p></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="row margin-top--sm theme-doc-footer-edit-meta-row"><div class="col noPrint_WFHX"><a href="https://github.com/openrag/openrag/tree/main/docs/docs/support/troubleshoot.mdx" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_JAkA"></div></div></footer></article><nav class="docusaurus-mt-lg pagination-nav" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/reference/configuration"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Environment variables</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="#opensearch-fails-to-start" class="table-of-contents__link toc-highlight">OpenSearch fails to start</a></li><li><a href="#openrag-fails-to-start-from-the-tui-with-operation-not-supported" class="table-of-contents__link toc-highlight">OpenRAG fails to start from the TUI with operation not supported</a></li><li><a href="#openrag-installation-fails-with-unable-to-get-local-issuer-certificate" class="table-of-contents__link toc-highlight">OpenRAG installation fails with unable to get local issuer certificate</a></li><li><a href="#langflow-connection-issues" class="table-of-contents__link toc-highlight">Langflow connection issues</a></li><li><a href="#container-out-of-memory-errors" class="table-of-contents__link toc-highlight">Container out of memory errors</a></li><li><a href="#memory-issue-with-podman-on-macos" class="table-of-contents__link toc-highlight">Memory issue with Podman on macOS</a></li><li><a href="#port-conflicts" class="table-of-contents__link toc-highlight">Port conflicts</a></li><li><a href="#ocr-ingestion-fails-easyocr-not-installed" class="table-of-contents__link toc-highlight">OCR ingestion fails (easyocr not installed)</a></li><li><a href="#langflow-container-already-exists-during-upgrade" class="table-of-contents__link toc-highlight">Upgrade fails due to Langflow container already exists</a></li><li><a href="#document-ingestion-or-similarity-search-issues" class="table-of-contents__link toc-highlight">Document ingestion or similarity search issues</a></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>© 2025 OpenRAG</span>
</div></li></ul></div></div></div></footer></div>
</body>