Troubleshooting Notes

If you encounter issues while using FastGPT, follow the steps below to troubleshoot and resolve them.

1. Check Version and Upgrade

Many known issues are fixed in newer releases. Before reporting a problem, verify your version first:

• Check version: View the current running version on the FastGPT homepage or in the admin panel.
• Upgrade recommendation: If you are not on the latest version, follow the Upgrade Guide to update to the latest stable release.

2. Troubleshooting Steps

If the issue still exists after upgrading, check in this order:

• Check logs: Review Docker container logs or server logs and locate the specific error stack.
• Clear cache: Clear browser cache or retry in incognito mode.
• Environment check: Ensure MongoDB and PostgreSQL/Milvus connections are healthy and API keys are valid.

3. Contact Technical Support

If the issue still cannot be resolved, contact us through:

• Community feedback: Search for similar issues in GitHub Issues or community channels.
• Provide details: When contacting support, include:
  • Full version number currently in use.
  • Detailed issue description with reproduction steps.
  • Related system error logs or screenshots.