{"id":14972,"date":"2025-11-06T10:40:42","date_gmt":"2025-11-06T16:40:42","guid":{"rendered":"https:\/\/www.mrc-productivity.com\/docs\/?post_type=ht_kb&#038;p=14972"},"modified":"2025-11-11T08:39:13","modified_gmt":"2025-11-11T14:39:13","slug":"installing-chromadb","status":"publish","type":"ht_kb","link":"https:\/\/www.mrc-productivity.com\/docs\/knowledge-base\/installing-chromadb","title":{"rendered":"Installing ChromaDB"},"content":{"rendered":"\n<p>ChromaDB is a high-performance vector database designed to store and search large volumes of AI-processed text efficiently. While m-Power includes a built-in vector database suitable for testing and smaller documents, mrc <strong>strongly recommend<\/strong> installing ChromaDB when deploying your AI Assistants and Content Retrievers in a production environment. ChromaDB is optimized for larger files, multiple uploads, and faster search performance \u2014 making it the preferred choice for live environments where accuracy and reliability are essential.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Windows Installation<\/h2>\n\n\n\n<p>Follow these steps to install ChromaDB on Windows:<\/p>\n\n\n\n<ol start=\"1\" class=\"wp-block-list\">\n<li>Download and Extract:\n<ul class=\"wp-block-list\">\n<li><strong><a href=\"http:\/\/mrc-productivity.com\/products\/mpower\/ChromaDB.zip\">Download the ChromaDB package.<\/a><\/strong><\/li>\n\n\n\n<li>Unzip ChromaDB.zip to a temp folder (e.g. C:\\temp).<\/li>\n\n\n\n<li>Move the extracted ChromaDB folder to C:.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Install Python:\n<ul class=\"wp-block-list\">\n<li><strong><a href=\"http:\/\/mrc-productivity.com\/products\/mpower\/python-3.13.8-amd64.exe\">Download the Python installer here.<br><\/a><\/strong>(Note: Python 3.13 is the supported version for ChromaDB.)<\/li>\n\n\n\n<li>Move the .exe to C:\\ChromaDB.<\/li>\n\n\n\n<li>Right-click the installer and choose \u201cRun as Administrator\u201d.<\/li>\n\n\n\n<li>Check \u201cAdd to PATH\u201d and \u201cUse admin privileges\u201d.<\/li>\n\n\n\n<li>Choose \u201cCustomize Install\u201d, keep defaults, and set install path to:<br><em>C:\\ChromaDB\\Python313<\/em><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Install ChromaDB:\n<ul class=\"wp-block-list\">\n<li>Open Command Prompt as Administrator.<\/li>\n\n\n\n<li>Type: <code>pip install chromadb<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Verify Configuration:\n<ul class=\"wp-block-list\">\n<li>Edit C:\\ChromaDB\\Chroma-DB-Service.xml.<\/li>\n\n\n\n<li>Verify the Python path (line 6) matches the install location from step 2.<\/li>\n\n\n\n<li>Change the port (line 7) if port 8000 is already in use.<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Install Windows Service:\n<ul class=\"wp-block-list\">\n<li>Open Command Prompt as Administrator.<\/li>\n\n\n\n<li>Type: <code>cd C:\\ChromaDB<\/code><\/li>\n\n\n\n<li>Type: <code>Chroma-DB-Service.exe install<\/code><\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>Start and Verify Service:\n<ul class=\"wp-block-list\">\n<li>Start the ChromaDB service from Windows Services.<\/li>\n\n\n\n<li>If it stops or fails, check logs in C:\\ChromaDB\\logs.<\/li>\n\n\n\n<li>Open <em>http:\/\/localhost:8000\/docs<\/em> to confirm ChromaDB is running.<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<div class=\"wp-block-group\"><div class=\"wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained\">\n<h2 class=\"wp-block-heading\" id=\"configure\">Configure m-Power<\/h2>\n\n\n\n<p>Once ChromaDB is installed and running, configure m-Power to use it as the vector database:<\/p>\n\n\n\n<ol start=\"1\" class=\"wp-block-list\">\n<li>Open the following file:<br>\/m-power\/mrcjava\/WEB-INF\/classes\/mrc-runtime.properties<\/li>\n\n\n\n<li>Add the following lines:<br><code>embedding_store_type=chroma<br>chroma_url=http:\/\/localhost:8000<\/code><\/li>\n\n\n\n<li>Save the file and restart Tomcat.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-alert\">Repeat the above steps in your production mrc-runtime.properties file as well.<\/p>\n<\/div><\/div>\n\n\n\n<div class=\"wp-block-group\"><div class=\"wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained\">\n<h2 class=\"wp-block-heading\">Troubleshooting<\/h2>\n\n\n\n<p>If the ChromaDB service fails to start or stops unexpectedly:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Check the logs at C:\\ChromaDB\\logs for detailed error messages.<\/li>\n\n\n\n<li>Ensure port 8000 is not already in use by another service.<\/li>\n\n\n\n<li>Confirm the Python path in C:\\ChromaDB\\Chroma-DB-Service.xml is correct.<\/li>\n\n\n\n<li>Verify ChromaDB was installed successfully by running: <code>pip show chromadb<\/code><\/li>\n<\/ul>\n\n\n\n<p>If issues persist, reinstall Python and ChromaDB following the steps above.<\/p>\n<\/div><\/div>\n\n\n\n<div class=\"wp-block-group\"><div class=\"wp-block-group__inner-container is-layout-constrained wp-block-group-is-layout-constrained\">\n<h2 class=\"wp-block-heading\">Linux Installation<\/h2>\n\n\n\n<p>Follow these steps to install ChromaDB on Linux:<\/p>\n\n\n\n<ol start=\"1\" class=\"wp-block-list\">\n<li>Install Docker: <code>yum install docker<\/code><\/li>\n\n\n\n<li>Install ChromaDB: <code>docker pull chromadb\/chroma<\/code><\/li>\n\n\n\n<li>When prompted, choose: docker.io\/chromadb\/chroma<\/li>\n\n\n\n<li>Start ChromaDB: <code>docker run -p 8000:8000 chromadb\/chroma<\/code><\/li>\n\n\n\n<li><a href=\"#configure\" data-type=\"internal\" data-id=\"#configure\"><strong>Configure m-Power by following the steps above.<\/strong><\/a><\/li>\n<\/ol>\n<\/div><\/div>\n","protected":false},"excerpt":{"rendered":"<p>ChromaDB is a high-performance vector database designed to store and search large volumes of AI-processed text efficiently. While m-Power includes a built-in vector database suitable for testing and smaller documents, mrc strongly recommend installing ChromaDB when deploying your AI Assistants and Content Retrievers in a production environment. ChromaDB is optimized&#8230;<\/p>\n","protected":false},"author":1,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[313],"ht-kb-tag":[],"class_list":["post-14972","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-artificial-intelligence-ai"],"_links":{"self":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/14972","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/comments?post=14972"}],"version-history":[{"count":9,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/14972\/revisions"}],"predecessor-version":[{"id":14989,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb\/14972\/revisions\/14989"}],"wp:attachment":[{"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/media?parent=14972"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-category?post=14972"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.mrc-productivity.com\/docs\/wp-json\/wp\/v2\/ht-kb-tag?post=14972"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}