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

Описание и применение

Автор развернул FastGPT на Linux с Docker, столкнувшись с тремя проблемами: недоступность MinIO из Docker Hub, неверный формат 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 deployed successfully after addressing three critical issues: using a China‑based MinIO mirror, correcting CSV FAQ header, and providing an embedding model.

Рабочий процесс

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

Доказательства

The MinIO image no longer pulls from Docker Hub.

Источник

CSV FAQ import needs a third column. 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 ("System not embedding model"). DeepSeek alone isn't enough.

Источник