Chroma 教程 收藏

用 systemd 托管(没用 Docker 的情况)

🎉摘要:本文介绍不使用Docker,通过pip安装ChromaDB并使用systemd托管服务的完整步骤,包括创建chroma.service文件、daemon-reload、enable开机自启、start启动服务及journalctl查看日志,帮助你在Linux上稳定运行ChromaDB向量数据库。

如果你不想使用 Docker 安装 ChromaDB 服务,也可以使用 systemd 进行托管。

详细步骤如下:

(1)运行 pip install chromadb 安装 ChromaDB 库,安装后就可以使用 chroma 命令了。

(2)运行 chroma --version 命令,查看版本信息:

root@localhost:~/chroma-data# chroma --version
chroma 1.4.4

(3)查看 chroma 命令所在的位置:

root@localhost:~/chroma-data# whereis chroma
chroma: /usr/local/bin/chroma

(4)进入到 /etc/systemd/system 目录下面创建 chroma.service 文件,内容如下:

# /etc/systemd/system/chroma.service
[Unit]
Description=Chroma Vector Database
After=network.target

[Service]
Type=simple
User=root
Group=root
WorkingDirectory=/opt/chroma
ExecStart=/usr/local/bin/chroma run --path /data/chroma --host 0.0.0.0 --port 8000
Restart=always
RestartSec=5
Environment=CHROMA_ALLOW_RESET=false
Environment=ANONYMIZED_TELEMETRY=false

[Install]
WantedBy=multi-user.target

注意,如果 /opt/chroma 目录不存在,请执行 mkdir /opt/chroma 命令进行创建。

(5)使用 systemctl 命令管理创建的 chroma.service 服务,执行如下命令:

  • sudo systemctl daemon-reload:重新加载 systemd 的服务单元配置 当你新建 / 修改了 /etc/systemd/system/chroma.service 这类服务配置文件之后,systemd 不会自动识别改动,必须执行这条命令,让系统读取最新的 service 文件。  

  • sudo systemctl enable chroma:设置开机自启 ,操作系统开机的时候,自动启动 chroma 这个服务。  

  • sudo systemctl start chroma:立即启动 chroma 服务 启动已经注册好的 chroma systemd 服务,在后台持续运行。  

  • sudo journalctl -u chroma -f:实时追踪查看 chroma 服务日志

    • -u chroma:只筛选 chroma 单元的日志

    • -f:follow,持续滚动输出新日志(类似 tail -f)

# 重新加载 systemd 服务
root@localhost:/etc/systemd/system# systemctl daemon-reload

# chroma 服务开机启动
root@localhost:/etc/systemd/system# systemctl enable chroma
Created symlink /etc/systemd/system/multi-user.target.wants/chroma.service → /etc/systemd/system/chroma.service.

# 启动 chroma 服务
root@localhost:/etc/systemd/system# systemctl start chroma

# 查看 chroma 服务日志信息
root@localhost:/etc/systemd/system# journalctl -u chroma -f
Nov 10 17:26:20 localhost chroma[2396]: Saving data to: /data/chroma
Nov 10 17:26:20 localhost chroma[2396]: Connect to Chroma at: http://localhost:8000
Nov 10 17:26:20 localhost chroma[2396]: Getting started guide: https://docs.trychroma.com/docs/overview/getting-started
Nov 10 17:26:20 localhost chroma[2396]: ☁️ To deploy your DB - try Chroma Cloud!
Nov 10 17:26:20 localhost chroma[2396]: - Sign up: https://trychroma.com/signup
Nov 10 17:26:20 localhost chroma[2396]: - Copy your data to Cloud: chroma copy --to-cloud --all
Nov 10 17:26:20 localhost chroma[2396]:   2026-11-10T09:26:20.864602Z  INFO  Global tracing subscriber set
Nov 10 17:26:20 localhost chroma[2396]:     at rust/tracing/src/init_tracer.rs:370
Nov 10 17:26:20 localhost chroma[2396]:   2026-11-10T09:26:20.884655Z  INFO  Frontend server listening on address, addr: 0.0.0.0:8000
Nov 10 17:26:20 localhost chroma[2396]:     at rust/frontend/src/server.rs:416

也可以使用 systemctl status chroma 命令查看状态,如下图:

从日志可以看出,chroma 启动成功,可以使用工具验证。如果不想开机启动,可以使用 systemctl disable chroma 禁用开机自启:

root@localhost:/etc/systemd/system# systemctl disable chroma
Removed /etc/systemd/system/multi-user.target.wants/chroma.service.

  

说说我的看法
全部评论()
没有评论
关于
本网站专注于 Java、数据库(MySQL、Oracle)、Linux、软件架构及大数据等多领域技术知识分享。涵盖丰富的原创与精选技术文章,助力技术传播与交流。无论是技术新手渴望入门,还是资深开发者寻求进阶,这里都能为您提供深度见解与实用经验,让复杂编码变得轻松易懂,携手共赴技术提升新高度。如有侵权,请来信告知:hxstrive@outlook.com
其他应用
公众号