TroubleshootingOfficial documentation34 min readIssue list

FastGPT Environment and configuration Issue List

Explore Environment and configuration Issue List with symptom-based checks, published article links and practical guidance for troubleshooting your deployment.

This page collects the 125 published documents about environment variables and configuration files, 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 setting appears correct but has no effect at runtime
  2. A variable removed in a newer version is still present in the configuration
  3. Values differ between the orchestration file and the environment file

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 (125)

DocumentArea
Access and Configure FastGPT AI Settingstutorial
Add FastGPT 4.15 Environment Configuration Variablesdeploy
Add Models to Existing FastGPT Provider Configurationsmodel
Add OpenAI o1 Models to FastGPT Configurationdeploy
Add Third-Party API Dataset Configuration Formsintegration
Add and Configure Custom FastGPT Modelsdeploy
Clarify FastGPT model configuration terminologydeploy
Clean Up Legacy FastGPT System Model Configsdeploy
Configure AI Models for FastGPT Chat Nodesnode
Configure Agent Sandbox Package Registry Mirrorsdeploy
Configure Agent Sandbox Proxy for FastGPT 4.16.0deploy
Configure Associated Skills and Tools for FastGPT Agent V2tutorial
Configure Batch Processing Node Input Parametersnode
Configure Cloudflare R2 for FastGPT Object Storagedeploy
Configure Custom Domains for FastGPT Servicestutorial
Configure Custom Package Registries for FastGPT Sandboxesdeploy
Configure DingTalk App Permissions for FastGPT Datasetintegration
Configure DingTalk Dataset Integration for FastGPTintegration
Configure External Citation Visibility for FastGPT Shared Linkstutorial
Configure FastGPT AI Reasoning Effort Settingstutorial
Configure FastGPT Admin Team Operational Modestutorial
Configure FastGPT Admin-Specific Environment Variablesdeploy
Configure FastGPT Agent Sandbox Environment Variablesdeploy
Configure FastGPT Agent Sandbox Proxy Servicedeploy
Configure FastGPT Agent V2 Virtual Machine Sandboxtutorial
Configure FastGPT Application Voice Input Settingstutorial
Configure FastGPT Code Sandbox Environment Variablesdeploy
Configure FastGPT Commercial Share Link Authenticationintegration
Configure FastGPT Dataset Collection Creation Parametersapi
Configure FastGPT Dataset and File Upload Settingstutorial
Configure FastGPT Document Parsing Workflow Settingstutorial
Configure FastGPT File Download URL Modedeploy
Configure FastGPT HTTP Node Output Formattingnode
Configure FastGPT Logging and OTEL Collectiondeploy
Configure FastGPT Logging, Metrics, and Tracingdeploy
Configure FastGPT Loop Run Node Input Parametersnode
Configure FastGPT Main Service for Remote Debuggingdeploy
Configure FastGPT Object Storage Access Modesdeploy
Configure FastGPT OpenSandbox Runtime Environment Settingsdeploy
Configure FastGPT Parallel Run Deployment Parametersnode
Configure FastGPT Plugin Local-Pool Runtime Parametersmodel
Configure FastGPT Plugin Server for Remote Debuggingdeploy
Configure FastGPT Pro Environment Variables for v4.15.1deploy
Configure FastGPT Publish Link Parameter Settingsintegration
Configure FastGPT Question Classification Category Parametersnode
Configure FastGPT Question Classification System Promptnode
Configure FastGPT Retrievers for RAG Workflowstutorial
Configure FastGPT Sandbox Resource and Lifecycle Settingsdeploy
Configure FastGPT Self-Hosted Deployment Environment Variablesdeploy
Configure FastGPT Shared App Databases, Cache, and Vector Storesdeploy
Configure FastGPT Shared App Security Variablesdeploy
Configure FastGPT Shared Domain and Runtime Variablesdeploy
Configure FastGPT Shared Service URLs and Integrationsdeploy
Configure FastGPT Supported Object Storage Providersdeploy
Configure FastGPT Volume Manager Environment Variablesdeploy
Configure FastGPT Web Site Dataset Synctutorial
Configure FastGPT Workflow Loop Body Parametersnode
Configure FastGPT content extraction target fieldsnode
Configure FastGPT content review and rewrite workflowstutorial
Configure FastGPT dataset search parameters and modestutorial
Configure FastGPT for MinerU Custom Modelsdeploy
Configure FastGPT model provider connectionsdeploy
Configure Feishu Bot Callback Events and Permissionsintegration
Configure Feishu Publishing Callback URLsintegration
Configure Identity Proxy Headers for FastGPT MCP Serversintegration
Configure Legacy Marker Parsing for FastGPTdeploy
Configure Max Conversation Histories for FastGPTtutorial
Configure MinerU PDF Parsing for FastGPTdeploy
Configure Multimodal Recognition Settings in FastGPTtutorial
Configure Multiple Selectors for FastGPT Web Synctutorial
Configure OpenSandbox Settings for FastGPT Servicesdeploy
Configure OpenSandbox for FastGPT Self-Hosted Deploymentsdeploy
Configure Package Registries for FastGPT Sandboxesdeploy
Configure Parallel Task Execution in FastGPT Workflowsnode
Configure Plugin Paths and Live Reload for Remote Debuggingmodel
Configure Required Models for FastGPT Deploymentdeploy
Configure Secure FastGPT Gateway Reverse Proxydeploy
Configure SiliconCloud for FastGPT Self-Hosted Deploymentsdeploy
Configure Startup Scripts for FastGPT VM Sandboxestutorial
Configure Tencent Cloud COS for FastGPTdeploy
Configure Third-Party App Variables for FastGPTintegration
Configure WeCom Single Sign-On for FastGPTtutorial
Configure and Adopt FastGPT 491 New Featuresdeploy
Configure and Call Individual FastGPT MCP Toolsintegration
Configure and Evaluate FastGPT RAG Workflowstutorial
Configure and Manage FastGPT Agent VM Lifecycle Scriptstutorial
Configure and Test Speech-to-Text in FastGPT Appsdeploy
Configure and Use FastGPT Basic Mode File Inputtutorial
Configure and Use FastGPT MCP Toolkit Callsintegration
Configure and Use FastGPT RAG Generatorstutorial
Configure and Use FastGPT Specified Reply Nodesnode
Configure and Use FastGPT Tool Calling Nodesnode
Configure and Use File Input in FastGPT Workflowstutorial
Configure and run FastGPT RAG generation phasetutorial
Configure and use FastGPT HTTP workflow nodesnode
Create and Configure FastGPT MCP Toolkitsintegration
Create and Configure FastGPT Skill Workspacestutorial
Define Parameters Extraction Requirements for Content Extract Nodesnode
Edit FastGPT Self-Hosted Model Configuration Settingsdeploy
FastGPT 4.12.2 New Admin Configuration Featuresdeploy
FastGPT 4.14.10 Performance and Configuration Optimizationsdeploy
FastGPT Commercial Edition 4.6.6 Configuration Changesdeploy
Generate and Optimize FastGPT Agent Configurationstutorial
Install and Configure MinerU for FastGPT Parsingdeploy
Loop Run Node Output Parameter Referencenode
New Plugin Additions and Configurations for FastGPT 4.13.2deploy
Official FastGPT Self-Hosted Environment Configuration Notesdeploy
Optimize and Configure FastGPT RAG Deploymentstutorial
Set Up Additional FastGPT App Environment Variablesdeploy
Set Up FastGPT Shared Environment Variablesdeploy
Set Up FastGPT Shared Environment Variablesdeploy
Update AGENT_ENGINE Environment Variables for FastGPT 4.15.2deploy
Update FastGPT 4.16.0 Environment Variablesdeploy
Update FastGPT 4.6 and Revise Configuration Filesdeploy
Update FastGPT App and Pro Sandbox Environment Variablesdeploy
Update FastGPT Configuration for Tool Choice Changesdeploy
Update FastGPT Environment Variables for 4.14.9deploy
Update FastGPT LLM and Vector Model Configurationsdeploy
Update FastGPT Logging Environment Variablesdeploy
Update FastGPT MCP Proxy Server Configurationdeploy
Update FastGPT V4.2 QAModel Configuration Formatdeploy
Update VectorModels Config for FastGPT v4.2.1deploy
Use System Variables in HTTP Node Request Parametersnode
Verify FastGPT MCP Identity Proxy Configurationintegration
Verify Operational Status of Configured FastGPT Model Channelsdeploy

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