TroubleshootingOfficial documentation10 min readIssue list

FastGPT Databases and object storage Issue List

Find 17 FastGPT database and object-storage troubleshooting articles, with checks for connections, permissions, capacity, and version changes.

This page collects the 17 published documents about database connections and object storage configuration, grouped by symptom, so a document can be found directly from what the error looks like.

Three symptoms that belong to this stage

  1. A database connection fails to open or drops during use
  2. Object storage read and write permissions or endpoint settings are wrong
  3. The vector store component version does not match the main service

If none of the three match, go back to the deployment and environment issue landscape and narrow down again.

The general order for this stage

  1. Take the full error from the backend service log for this stage's component, including the component name and error code
  2. Verify from inside the deployment that the component can be reached on its own, ruling out network and permission causes
  3. Check the component version against the main service version
  4. Follow the entry below whose symptom is closest, then repeat the same operation to verify

Published documents (17)

DocumentArea
Configure AWS S3 for FastGPT Storagedeploy
Configure Alibaba Cloud OSS for FastGPT Self-Hostingdeploy
Configure FastGPT Full-Text Search for Milvus BM25deploy
Configure MongoDB Index Sync for FastGPT 4.15.4deploy
Configure Redis for FastGPT Self-Hosted Upgradesdeploy
Delete Legacy Milvus modeldata Tables Post Migrationdeploy
FastGPT V4.5 PgVector Index Upgrade Guidedeploy
Fix FastGPT S3 Connection Configuration Issuesdeploy
Fix Incorrect TTL for MongoDB Bill Collectiondeploy
Migrate FastGPT MongoDB Deployments With mongodumpdeploy
Properly Upgrade FastGPT Across Multiple Versionsdeploy
Rename MongoDB Collections for FastGPT V4 Upgradedeploy
Resolve Failed FastGPT Mongo Replica Set Auto-Initializationdeploy
Resolve FastGPT Milvus Data Precision Lossdeploy
Resolve FastGPT MongoDB Connection Timeout Errorsdeploy
Troubleshoot FastGPT Milvus BM25 Integration Issuesdeploy
Upgrade Milvus to 2.5.16+ for FastGPTdeploy

What this list does not cover

Entries cover cases that can be reproduced publicly, grouped by symptom. The following need separate confirmation:

  • A symptom caused by several factors at once, which needs the order above to rule them out one by one
  • The same symptom caused by configuration specific to the commercial edition
  • Cases coupled to a particular infrastructure environment that cannot be reproduced in a standard deployment

Keep reading

References

If the problem is still not located

The entries above cover cases that can be reproduced from public information. If the problem depends on configuration details of a specific deployment, or needs runtime logs to confirm, contact sales for deployment-stage support; the cloud service can be used directly without handling environment dependencies.

  • Contact sales: support for self-hosting and upgrades
  • Get started: use the cloud service and skip environment setup
  • Pricing: compare what the cloud and self-hosted forms cover