I self-hosted an AI support bot with FastGPT + Docker — 3 gotchas that will break your install

说明与用途

在 Linux 上使用 Docker 安装 FastGPT 失败，原因是缺少 MinIO 镜像、CSV FAQ 格式不正确以及缺少嵌入模型。

问题

Installing FastGPT v4.15 on a fresh Linux box with Docker fails due to missing MinIO image, incorrect CSV FAQ format, and lack of an embedding model.

结果

FastGPT runs on a 4 GB VPS with proper MinIO image, CSV FAQ format, and embedding model, avoiding common installation pitfalls.

工作流

• Pull FastGPT Docker images
• Replace MinIO image with registry.cn-hangzhou.aliyuncs.com/fastgpt/minio
• Ensure CSV FAQ header is "q,a,indexes"
• Configure an embedding model (e.g., DeepSeek)
• Start FastGPT containers
• Verify knowledge‑base creation

证据

The MinIO image no longer pulls from Docker Hub.

来源

The header must be q,a,indexes, not q,a, or the import is rejected with a format error.

来源

You need an embedding model, not just a chat model. Without one, you can't even create a knowledge base.

来源