TroubleshootingOfficial documentation30 min readIssue list

FastGPT Upgrades and migrations Issue List

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

This page collects the 114 published documents about the upgrade process and behaviour after upgrading, grouped by symptom, so a document can be found directly from what the error looks like.

Three symptoms that belong to this stage

  1. Behaviour changes after an upgrade
  2. An upgrade stops partway or has to be rolled back
  3. Dependency order when skipping several versions

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

DocumentArea
Add Agent-Sandbox Configuration for FastGPT Upgradedeploy
Add Mandatory Environment Variables for FastGPT 4.15 Upgradedeploy
Adjust FastGPT Environment Variables for 4.15.04 Upgradedeploy
Check FastGPT Version and Upgrade to Resolve Issuesdeploy
Complete Required FastGPT Commercial Edition Initializationdeploy
Configure Agent Sandbox Environment Variables for FastGPT 4.16.1 Upgradedeploy
Configure FastGPT 4.14.11 Upgrade Environment Variablesdeploy
Configure and Upgrade FastGPT ReRank Modelsdeploy
Critical Impacts of FastGPT 4.15.00 Upgradedeploy
Deploy FastGPT MCP Server for Self-Hosted Upgradesdeploy
Detailed Technical Improvements for FastGPT 4.15.5 Upgradedeploy
Enforce FastGPT Skill Initialization Execution Constraintstutorial
Execute FastGPT 4.15 Upgrade Migration Scriptsdeploy
Execute FastGPT 4.8.6 Application Permission Initializationdeploy
Execute FastGPT 4.8.8 Dataset Permission Initializationdeploy
Execute FastGPT v4.12.1 Commercial Migration Scriptdeploy
Execute FastGPT v4.14.51 Admin Upgrade Scriptdeploy
Execute FastGPT v462 Initialization API for Self-Hosted Deploymentsdeploy
Execute FastGPT v464 Administrative Initialization APIdeploy
Execute Self-Hosted FastGPT 4.14.7 Upgrade Scriptdeploy
Execute the FastGPT 4.9.1 Upgrade Scriptdeploy
FastGPT 4.12.4 Key Functional Upgrade Improvementsdeploy
FastGPT 4.14.9 Upgrade Key Improvement Detailsdeploy
FastGPT 4.15.0 Environment Variable Upgrade Changesdeploy
FastGPT 4822 Upgrade New Technical Featuresdeploy
FastGPT 490 Upgrade New Feature Detailsdeploy
FastGPT 491 Version Bug Fix Detailsdeploy
FastGPT 4910 Version Feature Improvement Breakdowndeploy
FastGPT 4910 Version New Feature Enhancementsdeploy
FastGPT 4911 Version New Feature Updatesdeploy
FastGPT 4912 Technical Upgrade Feature Detailsdeploy
FastGPT 4912 Upgrade Functional Improvementsdeploy
FastGPT 498 Upgrade New Feature Breakdowndeploy
FastGPT Sandbox Environment Variable Changes for 4.15.03 Upgradedeploy
FastGPT Self-Hosted Upgrade 496 Feature Improvementsdeploy
FastGPT Version 4819 Release Updatesdeploy
FastGPT Version 4821 Full Release Notesdeploy
FastGPT v4.13.0 Core Technical Upgrade Improvementsdeploy
FastGPT v4.14.5 Upgrade New Feature Detailsdeploy
FastGPT v4818 Upgrade Feature and Fix Summarydeploy
Initialize API Key App Names for 4.15.1 Upgradedeploy
Initialize FastGPT Commercial Edition Upgrade Datadeploy
Initialize FastGPT dataset.files collection via APIdeploy
Initialize Missing Fields in FastGPT Database Collectionsdeploy
Key FastGPT Self-Hosted Upgrade Performance Improvementsdeploy
Key FastGPT v492 Version Upgrade Improvementsdeploy
Key Improvements in FastGPT 491 Self-Host Upgradedeploy
Key Technical Improvements for FastGPT 490 Upgradedeploy
Migrate Chat Title Model Configuration for FastGPT Upgradedeploy
Migrate FastGPT Agent Sandbox Data for 4.16.0deploy
Migrate FastGPT Config to Environment Variablesdeploy
Migrate FastGPT Datasets for 4.14.3 Upgradedeploy
Migrate FastGPT Pro SSO and Sync Configurationsdeploy
Migrate FastGPT Workflow V1 to V2 Data During Upgradedeploy
Migrate FastGPT config.json to environment variablesdeploy
Migrate Legacy FastGPT File Upload Workflowsdeploy
Migrate Manual HTTP Tool Data for FastGPT 4.16.0deploy
Migrate OneAPI Channels to AI Proxydeploy
Migrate User Avatars for FastGPT v4819 Upgradedeploy
Migrate User-Bound OpenAI Accounts for FastGPT v4817deploy
Migrate and Clean Up Legacy Skill Debug Chat Datadeploy
New Features for FastGPT Self-Host Upgradesdeploy
Perform FastGPT 4811 Commercial Edition Initializationdeploy
Perform FastGPT v469 Initialization Operations for Self-Hosted Deploymentsdeploy
Procedures for FastGPT Application Version Rollbackstutorial
Reinstall FastGPT System Tools During Upgradedeploy
Reinstall FastGPT System Tools During Upgradedeploy
Resolved Bugs for FastGPT 4.13.0 Upgradedeploy
Resolved Bugs for FastGPT 4.14.0 Upgradedeploy
Resolved Bugs for FastGPT 4822 Upgradedeploy
Resolved FastGPT 498 Upgrade Bug Fixesdeploy
Resolved Issues and Improvements for FastGPT 4823 Upgradedeploy
Resolved Issues in FastGPT 4.14 Upgrade Scriptsdeploy
Resolved Issues in FastGPT 4.14.9 Upgradedeploy
Resolved Issues in FastGPT v4.15.07 Upgradedeploy
Run FastGPT 4.12.4 Commercial Migration Scriptdeploy
Run FastGPT 4.14.0 System Tool Migrationdeploy
Run FastGPT 4.8.23 Migration Script for Dataset Cleanupdeploy
Run FastGPT 4.8.5 Upgrade Initialization Commandsdeploy
Run FastGPT 4810 Administrative Initialization Tasksdeploy
Run FastGPT 4822 Contact Data Migrationdeploy
Run FastGPT Commercial Edition Initialization Stepsdeploy
Run FastGPT Post-Upgrade Initialization API Requestsdeploy
Run FastGPT v4.12.0 Commercial Migration Scriptdeploy
Run FastGPT v4.8.18 Full-Text Migration Scriptdeploy
Run FastGPT v445 Variable Node Initializationdeploy
Run FastGPT v447 Initialization APIdeploy
Run FastGPT v451 Initialization APIdeploy
Run Official FastGPT v4.14.5 Upgrade Scriptdeploy
Run Required FastGPT v46 Initialization APIsdeploy
Run Required FastGPT v4815 Post-Upgrade Migration Scriptsdeploy
Run the FastGPT 4.13.2 Upgrade Scriptdeploy
Run the FastGPT 4.14.1 Upgrade Scriptdeploy
Run the FastGPT 4.14.4 Upgrade Scriptdeploy
Run the FastGPT 4.9.4 Upgrade Scriptdeploy
Run the FastGPT 4.90 Upgrade Scriptdeploy
Run the FastGPT 4101 Commercial Migration Scriptdeploy
Run the FastGPT 4820 Configuration Migration Scriptdeploy
Run the FastGPT v4.8.1 Initialization Scriptdeploy
Run the FastGPT v44 Initialization APIdeploy
Run the FastGPT v463 Initialization APIdeploy
Run the FastGPT v467 Initialization APIdeploy
Run the Official FastGPT v4911 Upgrade Scriptdeploy
Run the Required FastGPT v43 Initialization APIdeploy
Save and Publish FastGPT Version Snapshotstutorial
Set Up FastGPT Skill Initialization Scriptstutorial
Technical Improvements for FastGPT Self-Hosted Upgradesdeploy
Understand FastGPT Upgrade Script Core Requirementsdeploy
Understand FastGPT Workflow V2 Upgrade Changesdeploy
Update FastGPT Environment Variables for 4.13.0 Upgradedeploy
Update FastGPT System Plugins for 4.14.6 Upgradedeploy
Upgrade FastGPT System Plugins for 4.14.7deploy
Upgrade OpenSandbox to Fix Chinese File Downloadsdeploy
Validate Required Environment Variables for FastGPT Upgradedeploy

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