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

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

Установка FastGPT v4.15 на Linux с Docker прерывается тремя проблемами: недоступность MinIO из Docker Hub, неверный формат CSV FAQ и отсутствие модели эмбеддингов. Решения включают замену MinIO на зеркальный репозиторий, корректировку заголовка CSV и подключение модели эмбеддингов. Для стабильной работы требуется минимум 4 ГБ ОЗУ.

Задача

Installing FastGPT v4.15 on a fresh Linux box with Docker fails due to three specific issues.

Результат

FastGPT v4.15 was successfully deployed on a Linux VPS using Docker, with a functional MinIO mirror, correctly formatted FAQ CSV, and an embedding model, enabling full chatbot operation.

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

• Pull FastGPT Docker images from the official registry.
• Replace the MinIO image with the mirror image registry.cn-hangzhou.aliyuncs.com/fastgpt/minio to avoid Docker Hub pull errors.
• Prepare FAQ CSV with header "q,a,indexes"; ensure a third column exists to satisfy import requirements.
• Configure and launch an embedding model (e.g., DeepSeek) alongside the chat model to allow knowledge base creation.
• Bind FastGPT ports to 127.0.0.1 and set up a reverse proxy to avoid firewall issues.
• Allocate at least 4 GB RAM to the VPS to accommodate FastGPT’s memory usage (~2.1 GB idle).

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

The MinIO image no longer pulls from Docker Hub. pull access denied for minio/minio — MinIO pulled their public images.

Источник

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.

Источник

Idle memory on my test box was ~2.1 GB, so 2 GB RAM VPSes won't cut it — plan for 4 GB.

Источник