Merge pull request #4531 from Infisical/ENG-2785

Infisical Version Upgrade Tool

docs/self-hosting/guides/upgrading-infisical.mdx

@@ -41,9 +41,16 @@ Now, migrations run automatically during boot-up. This improvement streamlines t
    - Ensure you have a complete backup of your Postgres database.
    - Verify that your backup is current and accessible.
 
-2. **Select the Upgrade Version:**  
-   - Visit the [Infisical releases page](https://github.com/Infisical/infisical/releases) for a list of available versions.
-   - Look for releases with the prefix `infisical/` as there are other releases that are not related to the Infisical instance.
+2. **Plan Your Upgrade Path:**
+   - Use our [Upgrade Path Tool](https://app.infisical.com/upgrade-path) to analyze your upgrade path between your current version and target version.
+   - The tool will show you:
+     - **Breaking changes** that require action before upgrading
+     - **Database migrations** that may require additional settings or precautions
+     - **Step-by-step upgrade path** with intermediate versions if needed
+   - Review any breaking changes and plan necessary configuration updates before proceeding.
+   - Visit the [Infisical releases page](https://github.com/Infisical/infisical/releases) for a complete list of available versions.
+
+![Upgrade Path Tool showing breaking changes and migration information](/images/self-hosting/helper/upgrade-path-tool.png)
 
 3. **Start the Upgrade Process:**  
    - Launch the new version of Infisical. During startup, the application will automatically compare the current database schema with the updated schema in the code.