diff --git a/README.md b/README.md index 0edc01745..6d98c3b0b 100644 --- a/README.md +++ b/README.md @@ -14,6 +14,7 @@ [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/langflow-ai/langflow) > [!CAUTION] +> - Windows users of Langflow Desktop should **not** use the in-app update feature to upgrade to Langflow version 1.6.0. For upgrade instructions, see [Windows Desktop update issue](https://docs.langflow.org/release-notes#windows-desktop-update-issue). > - Users must update to Langflow >= 1.3 to protect against [CVE-2025-3248](https://nvd.nist.gov/vuln/detail/CVE-2025-3248) > - Users must update to Langflow >= 1.5.1 to protect against [CVE-2025-57760](https://github.com/langflow-ai/langflow/security/advisories/GHSA-4gv9-mp8m-592r) > diff --git a/docs/docs/Get-Started/get-started-installation.mdx b/docs/docs/Get-Started/get-started-installation.mdx index 8724dcb4f..9d7a00b0a 100644 --- a/docs/docs/Get-Started/get-started-installation.mdx +++ b/docs/docs/Get-Started/get-started-installation.mdx @@ -36,6 +36,11 @@ Langflow Desktop requires macOS 13 or later. + :::warning + If you are upgrading Langflow Desktop on Windows, **don't** use the in-app update feature to upgrade to Langflow version 1.6.0. + For more information, see [Known issues for 1.6.0](/release-notes#windows-desktop-update-issue). + ::: + 1. Navigate to [Langflow Desktop](https://www.langflow.org/desktop). 2. Click **Download Langflow**, enter your contact information, and then click **Download**. 3. Open the **File Explorer**, and then navigate to **Downloads**. diff --git a/docs/docs/Support/release-notes.mdx b/docs/docs/Support/release-notes.mdx index 6f6b7e88e..3a69b5347 100644 --- a/docs/docs/Support/release-notes.mdx +++ b/docs/docs/Support/release-notes.mdx @@ -17,6 +17,7 @@ Due to strict SemVer requirements, Langflow Desktop can have different patch ver Whenever possible, the Langflow team recommends installing new Langflow versions in a new virtual environment or VM before upgrading your primary installation. This allows you to [import flows](/concepts-flows-import#import-a-flow) from your existing installation and test them in the new version without disrupting your existing installation. In the event of breaking changes or bugs, your existing installation is preserved in a stable state. +If you are upgrading Windows Desktop to 1.6.0, don't auto-upgrade with the in-app **Update** button. Instead, follow the instructions in [Known issue: Don't auto-upgrade Windows Desktop](#windows-desktop-update-issue). ::: To avoid the impact of potential breaking changes and test new versions, the Langflow team recommends the following upgrade process: @@ -51,6 +52,42 @@ To avoid the impact of potential breaking changes and test new versions, the Lan Highlights of this release include the following changes. For all changes, see the [Changelog](https://github.com/langflow-ai/langflow/releases). +### Known issue: Don't auto-upgrade Windows Desktop {#windows-desktop-update-issue} + +:::warning +Windows users of Langflow Desktop should **not** use the in-app update feature to upgrade to Langflow version 1.6.0. +Only Windows Desktop users upgrading to Langflow version 1.6.0 are affected. +::: + +The **Update** button in Langflow Desktop will not work for Windows users, and may result in data loss. + +Instead, download a fresh installation from the [Langflow website](https://langflow.org) when a new version is available. + +Follow the instructions below to minimize the risk of losing flows. + +These instructions assume the default path for the Langflow database of `C:\Users\YOUR_USERNAME\AppData\Roaming\com.langflow\data\database.db` or `C:\Users\%YOUR_USERNAME%\AppData\Roaming\com.langflow\data\database.db`. Replace `YOUR_USERNAME` with your Windows username. + +1. Ensure you have Administrator privileges. +2. Ensure you have enough disk space for a second installation of Langflow. +3. Close Langflow, and ensure no Langflow process is running in Task Manager. +4. The Langflow 1.6.0 installer automatically performs a database backup in a later step, but an additional manual backup provides additional redundancy and is recommended. +To manually back up your Langflow database file, do the following: + 1. In Windows Explorer, navigate to `C:\Users\YOUR_USERNAME\AppData\Roaming\com.langflow\data\`. Replace `YOUR_USERNAME` with your Windows username. + 2. Copy the `database.db` at this location, and paste it to a safe location. +5. Download the Windows installer from the [Langflow website](https://langflow.org). +6. Run the Windows installer as an Administrator. To run the installer as an Administrator, right-click the executable and select **Run as administrator**. +7. Follow the Windows installer's guided steps. +The Langflow 1.6.0 installer automatically performs a database backup. +These steps install Langflow from scratch, and result in two Langflow installations: the previously installed version, and version 1.6.0. +This is expected behavior. +8. Start version 1.6.0 of Langflow, and confirm your flows behave as expected. +9. **If flows are missing**, restore your flows from your manual backup by doing the following: + 1. Close Langflow. + 2. Navigate to your backup location, and copy the `database.db` file. + 3. Replace the database file in the new installation's `data` directory. + 4. Start Langflow, and confirm your flows behave as expected. + 5. After confirmation, uninstall the previous version of Langflow, and keep version 1.6.0. + ### Breaking changes - Authentication enforced for Langflow API requests by default