diff --git a/docs/docs/Contributing/contributing-community.md b/docs/docs/Contributing/contributing-community.md
index 4cdf32ea8..f8ff278f0 100644
--- a/docs/docs/Contributing/contributing-community.md
+++ b/docs/docs/Contributing/contributing-community.md
@@ -3,7 +3,7 @@ title: Join the Langflow community
slug: /contributing-community
---
-
+There are several ways you can interact with the Langflow community and learn more about the Langflow project.
## Join the Langflow Discord server
@@ -11,15 +11,25 @@ Join the [Langflow Discord Server](https://discord.gg/EqksyE2EX9) to ask questio
## Follow Langflow on X
-Follow [@langflow_ai](https://twitter.com/langflow_ai) on X to get the latest news about Langflow.
+Follow [@langflow_ai](https://twitter.com/langflow_ai) on X to get the latest news about Langflow.
-## Star Langflow on GitHub
+## Star Langflow on GitHub
-You can [star Langflow in GitHub](https://github.com/langflow-ai/langflow).
+If you like Langflow, you can star the [Langflow GitHub repository](https://github.com/langflow-ai/langflow).
+Stars help other users find Langflow more easily, and quickly understand that other users have found it useful.
-By adding a star, other users will be able to find Langflow more easily, and see that it has been already useful for others.
+Because Langflow is an open-source project, the more visible the repository is, the more likely the project is to attract [contributors](/contributing-how-to-contribute).
-## Watch the GitHub repository for releases
+## Watch the GitHub repository
-You can [watch Langflow in GitHub](https://github.com/langflow-ai/langflow). If you select **Watching** instead of **Releases only** you will receive notifications when someone creates a new issue or question. You can also specify that you want to be notified only about new issues, discussions, and PRs so you can try to help solve those issues.
+You can watch the [Langflow GitHub repository](https://github.com/langflow-ai/langflow) to get notified about new releases and other repository activity.
+To get release notifications only, select **Releases only**.
+
+If you select **Watching**, you will receive notifications about new releases as well as issues, discussions, and pull requests, if you are interested in that activity.
+For information about customizing repository notifications, see the [GitHub documentation on repository subscriptions](https://docs.github.com/en/account-and-profile/managing-subscriptions-and-notifications-on-github/managing-subscriptions-for-activity-on-github/viewing-your-subscriptions).
+
+## Request enhancements and get help through GitHub
+
+You can also submit feature requests and get help with Langflow through the GitHub repository.
+For more information, see [Get help and request enhancements](/contributing-github-issues).
\ No newline at end of file
diff --git a/docs/docs/Contributing/contributing-github-discussion-board.md b/docs/docs/Contributing/contributing-github-discussion-board.md
deleted file mode 100644
index 0a64f8722..000000000
--- a/docs/docs/Contributing/contributing-github-discussion-board.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-title: Ask for help on the Discussions board
-slug: /contributing-github-discussions
----
-
-If you're looking for help with your code, consider posting a question on the Langflow [GitHub Discussions board](https://github.com/langflow-ai/langflow/discussions). The Langflow team cannot provide individual support via email. The team also believes that help is much more valuable if it's shared publicly, so that more people can benefit from it.
-
-Since the Discussions board is public, please follow this guidance when posting your code questions.
-
-* When describing your issue, try to provide as many details as possible. What exactly goes wrong? _How_ is it failing? Is there an error? "XY doesn't work" usually isn't that helpful for tracking down problems. Always remember to include the code you ran and if possible, extract only the relevant parts and don't just dump your entire script. This will make it easier for us to reproduce the error.
-
-* When you include long code, logs, or tracebacks, wrap them in `` and ` ` tags. This [collapses the content](https://developer.mozilla.org/en/docs/Web/HTML/Element/details) so the contents only becomes visible on click, making the issue easier to read and follow.
\ No newline at end of file
diff --git a/docs/docs/Contributing/contributing-github-issues.md b/docs/docs/Contributing/contributing-github-issues.md
index e49adddb2..0776ed98c 100644
--- a/docs/docs/Contributing/contributing-github-issues.md
+++ b/docs/docs/Contributing/contributing-github-issues.md
@@ -1,6 +1,41 @@
---
-title: Request an enhancement or report a bug
+title: Get help and request enhancements
slug: /contributing-github-issues
---
-The [Issues page in the Langflow repo](https://github.com/langflow-ai/langflow/issues) is kept up to date with bugs, improvements, and feature requests. Labels are used to help with sorting and discovery of issues of interest. For an overview of the system Langflow uses to tag issues and pull requests, see the Langflow repo's [labels page](https://github.com/langflow-ai/langflow/labels).
\ No newline at end of file
+The Langflow GitHub repository is an integral part of the [Langflow community](/contributing-community).
+
+In addition to general assistance with Langflow, the repository is the best place to report bugs and request enhancements to ensure that they are tracked by the Langflow project.
+
+## GitHub issues
+
+The [Issues page in the Langflow repository](https://github.com/langflow-ai/langflow/issues) is actively updated with bugs and feature requests.
+
+:::tip
+The best way to promote a request or bug is to comment on an existing issue.
+Highly active issues are more likely to receive attention from contributors.
+
+Before you report a bug or submit a feature request, search for existing similar issues.
+Use the [Langflow repository's labels](https://github.com/langflow-ai/langflow/labels) to help filter your search.
+:::
+
+## GitHub discussions
+
+If you need help with your code or Langflow in general, you can visit the [Langflow GitHub Discussions page](https://github.com/langflow-ai/langflow/discussions) or reach out through other [Langflow community](/contributing-community) channels.
+
+The Langflow team doesn't provide individual support over email, and the team believes that public discussions help more users by virtue of their discoverability.
+
+## Community guidelines and tips
+
+Because the Issues and Discussion pages are public, the Langflow team asks that you follow these guidelines when submitting questions and issues:
+
+* **Provide as many details as possible**: Simply stating that a feature doesn't work isn't helpful. The Langflow team needs details in order to recreate and find the issue.
+* **Explain what exactly went wrong**: Including error messages and descriptions of _how_ your code failed, not just the fact that it failed.
+* **Retrace your steps**: Explain what happened before the error, what you expected to happen instead of the error, and any recent changes you made, such as upgrading Langflow or a dependency.
+* **Describe your environment**: Include your operating system, Langflow version, Python version, and any other environment-related details that could have contributed to the issue.
+* **Include snippets of the code that failed**: Be sure to omit any sensitive values, and only provide parts relevant to the failure, rather than the entire script. Providing code snippets makes it much easier to reproduce errors, troubleshoot, and provide specific advice.
+ * If your submission includes long sections of code, logs, or tracebacks, wrap them in [details tags](https://developer.mozilla.org/en/docs/Web/HTML/Element/details) (` PASTE CODE HERE `) to collapse the content and make it easier to read your submission.
+* **Omit sensitive information**: Other than the information available on your public GitHub profile, don't include sensitive or personally identifying data, such as security keys, full names, personal identification numbers, addresses, and phone numbers.
+* **Be kind**: Although bugs can be frustrating with any software, remember that your messages are read by real people who want to help. While you don't have to be saccharine, there's no need to be rude to get support.
+ * Your issues and discussions are attached to your GitHub account, and they can be read by anyone on the internet, including current and potential employers and colleagues.
+ * The Langlow repository is a public GitHub repository and, therefore, subject to the [GitHub Code of Conduct](https://docs.github.com/en/site-policy/github-terms/github-community-code-of-conduct).
\ No newline at end of file
diff --git a/docs/docs/Develop/install-custom-dependencies.md b/docs/docs/Develop/install-custom-dependencies.md
index 27f840f6b..e838108f7 100644
--- a/docs/docs/Develop/install-custom-dependencies.md
+++ b/docs/docs/Develop/install-custom-dependencies.md
@@ -3,9 +3,37 @@ title: Install custom dependencies
slug: /install-custom-dependencies
---
-To install custom dependencies in your Langflow environment, add them with your package manager.
+Langflow provides optional dependency groups and support for custom dependencies to extend Langflow functionality.
-## Create a virtual environment for local testing
+## Install optional dependency groups
+
+Langflow OSS provides optional dependency groups that extend its functionality.
+
+These dependencies are listed in the [pyproject.toml](https://github.com/langflow-ai/langflow/blob/main/pyproject.toml#L191) file under `[project.optional-dependencies]`.
+
+Install dependency groups using pip's `[extras]` syntax. For example, to install Langflow with the `postgresql` dependency group, enter the following command:
+
+```bash
+uv pip install "langflow[postgresql]"
+```
+
+To install multiple extras, use commas to separate each dependency group:
+
+```bash
+uv pip install "langflow[deploy,local,postgresql]"
+```
+
+## Install custom dependencies
+
+To install your own custom dependencies in your Langflow environment, add them with your package manager.
+
+If you're working within a cloned Langflow repository, add dependencies with `uv add` because there is already a `pyproject.toml` file for uv to reference:
+
+```bash
+uv add langflow DEPENDENCY
+```
+
+### Use a virtual environment to test custom dependencies
When testing locally, use a virtual environment to isolate your dependencies and prevent conflicts with other Python projects.
@@ -20,14 +48,17 @@ source YOUR_LANGFLOW_VENV/bin/activate
uv pip install langflow matplotlib
```
-If you're working within a cloned Langflow repository, add dependencies with `uv add` because there is already a `pyproject.toml` file for uv to reference.
+If you're working within a cloned Langflow repository, add dependencies with `uv add` to reference the existing `pyproject.toml` file:
+
```bash
uv add langflow matplotlib
```
## Add dependencies to the Langflow project
-When contributing to Langflow itself, add dependencies to the project's configuration. Langflow uses a workspace with two packages:
+When contributing to Langflow itself, add dependencies to the project's configuration.
+
+Langflow uses a workspace with two packages:
* The `main` package (root level): For end-user features and main application code
* The `base` package (in `src/backend/base`): For core functionality and shared code
diff --git a/docs/docs/Get-Started/get-started-installation.md b/docs/docs/Get-Started/get-started-installation.md
index 4870d59db..2327d3ac8 100644
--- a/docs/docs/Get-Started/get-started-installation.md
+++ b/docs/docs/Get-Started/get-started-installation.md
@@ -30,20 +30,21 @@ Langflow can be installed in multiple ways:
- :::important
- Windows installations of Langflow Desktop require a C++ compiler, such as [Visual Studio](https://visualstudio.microsoft.com/downloads/), that may not be present on your system. If you receive a `C++ Build Tools Required!` error, follow the on-screen prompt to install Microsoft C++ Build Tools, or visit the Visual Studio download link above.
- :::
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**.
4. Double-click the downloaded `.msi` file, and then use the install wizard to install Langflow Desktop.
- 6. When the installation completes, open the Langflow application.
+
+ :::important
+ Windows installations of Langflow Desktop require a C++ compiler that may not be present on your system. If you receive a `C++ Build Tools Required!` error, follow the on-screen prompt to install Microsoft C++ Build Tools, or [install Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/).
+ :::
+
+ 5. When the installation completes, open the Langflow application.
After confirming that Langflow is running, create your first flow with the [Quickstart](/get-started-quickstart).
-
### Manage your version of Langflow Desktop
@@ -134,14 +135,16 @@ To delete the virtual environment, type `Remove-Item VENV_NAME`.
2. To install Langflow, run the following command.
- ```bash
- uv pip install langflow
- ```
+
+ ```bash
+ uv pip install langflow
+ ```
3. After installation, start Langflow:
- ```bash
- uv run langflow run
- ```
+
+ ```bash
+ uv run langflow run
+ ```
4. To confirm that a local Langflow instance is running, navigate to the default Langflow URL `http://127.0.0.1:7860`.
It can take a few minutes for Langflow to start.
@@ -150,165 +153,28 @@ After confirming that Langflow is running, create your first flow with the [Quic
### Manage Langflow OSS versions
-To manage your Langflow version, use the following commands.
+:::important
+The Langflow team recommends installing new Langflow versions in a new virtual environment before upgrading your primary installation.
-
-Manage Langflow OSS versions
+This allows you to [import flows](/concepts-flows#import-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.
+:::
-To upgrade Langflow to the latest version:
-
-```bash
-uv pip install langflow -U
-```
-
-To install a specific version of the Langflow package, add the required version to the command:
-
-```bash
-uv pip install langflow==1.3.2
-```
-
-To reinstall Langflow and all of its dependencies, add the `--force-reinstall` flag to the command:
-
-```bash
-uv pip install langflow --force-reinstall
-```
-
-
+To manage your Langflow OSS version, use the following commands:
+* Upgrade Langflow to the latest version: `uv pip install langflow -U`
+* Install a specific version of the Langflow package by adding the required version to the command, such as: `uv pip install langflow==1.3.2`
+* Reinstall Langflow and all of its dependencies: `uv pip install langflow --force-reinstall`
### Manage Langflow OSS dependencies
-Langflow OSS provides optional dependency groups that extend its functionality.
+Langflow OSS provides optional dependency groups and support for custom dependencies to extend Langflow functionality.
+For more information, see [Install custom dependencies](/install-custom-dependencies).
-These dependencies are listed in the [pyproject.toml](https://github.com/langflow-ai/langflow/blob/main/pyproject.toml#L191) file under `[project.optional-dependencies]`.
+## Troubleshoot Langflow installation and startup issues
-
-Install dependency groups
+If you encounter an issue when installing or running Langflow, see [Troubleshoot Langflow](/troubleshoot).
-Install dependency groups using pip's `[extras]` syntax. For example, to install Langflow with the `postgresql` dependency group, enter the following command:
+## Next steps
-```bash
-uv pip install "langflow[postgresql]"
-```
-
-To install multiple extras, enter the following command:
-
-```bash
-uv pip install "langflow[deploy,local,postgresql]"
-```
-
-To add your own custom dependencies, see [Install custom dependencies](/install-custom-dependencies).
-
-
-
-### Common OSS installation issues
-
-This is a list of possible issues that you may encounter when installing and running Langflow.
-
-
-No langflow.__main__ module
-
-When you try to run Langflow with the command `langflow run`, you encounter the following error:
-
-```bash
-> No module named 'langflow.__main__'
-```
-
-1. Run `uv run langflow run` instead of `langflow run`.
-2. If that doesn't work, reinstall the latest Langflow version with `uv pip install langflow -U`.
-3. If that doesn't work, reinstall Langflow and its dependencies with `uv pip install langflow --pre -U --force-reinstall`.
-
-
-
-
-Langflow runTraceback
-
-When you try to run Langflow using the command `langflow run`, you encounter the following error:
-
-```bash
-> langflow runTraceback (most recent call last): File ".../langflow", line 5, in from langflow.__main__ import mainModuleNotFoundError: No module named 'langflow.__main__'
-```
-
-There are two possible reasons for this error:
-
-1. You've installed Langflow using `pip install langflow` but you already had a previous version of Langflow installed in your system. In this case, you might be running the wrong executable. To solve this issue, run the correct executable by running `python -m langflow run` instead of `langflow run`. If that doesn't work, try uninstalling and reinstalling Langflow with `uv pip install langflow --pre -U`.
-2. Some version conflicts might have occurred during the installation process. Run `python -m pip install langflow --pre -U --force-reinstall` to reinstall Langflow and its dependencies.
-
-
-
-
-Something went wrong running migrations
-
-```bash
-> Something went wrong running migrations. Please, run 'langflow migration --fix'
-```
-
-Clear the cache by deleting the contents of the cache folder.
-
-This folder can be found at:
-
-- **Linux or WSL2 on Windows**: `home//.cache/langflow/`
-- **MacOS**: `/Users//Library/Caches/langflow/`
-
-This error can occur during Langflow upgrades when the new version can't override `langflow-pre.db` in `.cache/langflow/`. Clearing the cache removes this file but also erases your settings.
-
-If you wish to retain your files, back them up before clearing the folder.
-
-
-
-
-Langflow installation freezes at pip dependency resolution
-
-Installing Langflow with `pip install langflow` slowly fails with this error message:
-
-```text
-pip is looking at multiple versions of <> to determine which version is compatible with other requirements. This could take a while.
-```
-
-To work around this issue, install Langflow with [`uv`](https://docs.astral.sh/uv/getting-started/installation/) instead of `pip`.
-
-```text
-uv pip install langflow
-```
-
-To run Langflow with uv:
-
-```text
-uv run langflow run
-```
-
-
-
-
-Failed to build required package
-
-When you try to install Langflow on Linux, installation fails because of outdated or missing packages.
-
-```bash
-Resolved 455 packages in 18.92s
- × Failed to build `webrtcvad==2.0.10`
- ├─▶ The build backend returned an error
- ╰─▶ Call to `setuptools.build_meta:__legacy__.build_wheel` failed (exit status: 1)
-```
-
-1. Install the required build dependencies.
-
-```bash
-sudo apt-get update
-sudo apt-get install build-essential python3-dev
-```
-
-2. If upgrading your packages doesn't fix the issue, install `gcc` separately.
-
-```bash
-sudo apt-get install gcc
-```
-
-
-
-
-Installation failure from webrtcvad package
-
-If you experience an error from the `webrtcvad` package, run `uv pip install webrtcvad-wheels` in the virtual environment, and then try installing again.
-
-
\ No newline at end of file
+After installing Langflow, build and run a flow with the [quickstart](/get-started-quickstart).
\ No newline at end of file
diff --git a/docs/docs/Support/luna-for-langflow.md b/docs/docs/Support/luna-for-langflow.md
index 806df67b6..29d861c0a 100644
--- a/docs/docs/Support/luna-for-langflow.md
+++ b/docs/docs/Support/luna-for-langflow.md
@@ -1,24 +1,21 @@
---
-title: Luna for Langflow
+title: Enterprise support for Langflow
slug: /luna-for-langflow
---
-With [Luna for Langflow](https://www.datastax.com/products/luna-langflow) support, you can develop and deploy Langflow applications with confidence.
+With **Luna for Langflow** support, you can develop and deploy Langflow applications with confidence.
-**Luna** is a subscription to the Langflow expertise at DataStax. It's meant for users of Langflow who want all the benefits of running their own open-source deployments, but with the peace of mind that comes with having direct access to the team that has authored the majority of the Langflow code.
+Luna is a subscription to the Langflow expertise at DataStax. It's meant for Langflow users who want all the benefits of running their own open-source deployments, as well as the peace of mind that comes with having direct access to the team that has authored the majority of the Langflow code.
-**Luna** subscribers can get help with general-purpose and technical questions for their open-source Langflow deployments, and if an issue is encountered, DataStax is there to help.
+Luna subscribers can get help with general-purpose and technical questions for their open-source Langflow deployments.
+If an issue is encountered, DataStax is there to help.
-Ready to subscribe?
+:::info
+
+As of May 2025, Luna for Langflow support covers Langflow versions 1.4.x.
-Visit the [Luna for Langflow](https://www.datastax.com/products/luna-langflow) product page to get started.
+Subscribers must run a supported Python version to receive support.
+Supported versions are `>=3.10, <3.14`, which includes all version from 3.10 through 3.13.x, but not 3.14.
+:::
-## Supported software
-
-Luna for Langflow support covers only the following software versions for Langflow.
-
-Last updated: May 1, 2025
-
-## Core information
-- **Langflow Version**: `1.4.x`
-- **Python Version Required**: `>=3.10, <3.14`
\ No newline at end of file
+To subscribe or learn more, see [Luna for Langflow](https://www.datastax.com/products/luna-langflow).
\ No newline at end of file
diff --git a/docs/docs/Support/troubleshooting.md b/docs/docs/Support/troubleshooting.md
new file mode 100644
index 000000000..5102a3e26
--- /dev/null
+++ b/docs/docs/Support/troubleshooting.md
@@ -0,0 +1,156 @@
+---
+title: Troubleshoot Langflow
+slug: /troubleshoot
+---
+
+This page provides troubleshooting advice for issues you might encounter when using Langflow or contributing to Langflow.
+
+## Missing components
+
+As Langflow development continues, components are often recategorized or deprecated for better alignment or to prepare for new components.
+
+If a component appears to be missing from the expected location on the component sidebar, try the following:
+
+* Search for the component or check other component categories, including [Bundles](/components-bundle-components).
+* [Expose legacy components](/concepts-components#components-sidebar), which are hidden by default.
+* Check the [Changelog](https://github.com/langflow-ai/langflow/releases/latest) for component changes in recent releases.
+* Make sure the component isn't already present in your flow if it is a single-use component.
+
+If you still cannot locate the component, see [Langflow GitHub Issues and Discussions](/contributing-github-issues).
+
+## No input in the Playground
+
+If there is no text box for input in the Playground, make sure your flow has a [Input component](/components-io) that is connected to the **Input** port of another component.
+
+## Missing key, no key found, or invalid API key
+
+If you get an API key error when running a flow, try the following:
+
+* For all components that require credentials, make sure those components have a valid credential in the component's settings, such as the **API key** field.
+* If you store your credentials in [Langflow global variables](/configuration-global-variables), make sure you selected the correct global variable and that the variable contains a valid credential.
+* Make sure the provided credentials are active, have the required permissions, and, if applicable, have sufficient funds in the account to execute the required action. For example, model providers require credits to use their LLMs.
+
+## Langflow installation issues
+
+The following issues can occur when installing Langflow.
+
+### C++ build tools required for Langflow Desktop on Windows
+
+Microsoft Windows installations of Langflow Desktop require a C++ compiler that may not be present on your system. If you receive a `C++ Build Tools Required!` error, follow the on-screen prompt to install Microsoft C++ Build Tools, or [install Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/).
+
+### Langflow installation freezes at pip dependency resolution
+
+Installing Langflow OSS with `pip install langflow` slowly fails with this error message:
+
+```text
+pip is looking at multiple versions of <> to determine which version is compatible with other requirements. This could take a while.
+```
+
+To work around this issue, install Langflow with `uv` instead of `pip`, as explained in [Install and run the Langflow OSS Python package](/get-started-installation#install-and-run-the-langflow-oss-python-package).
+
+### Linux installation fails to build required package
+
+When you try to install Langflow OSS on Linux, installation fails because of outdated or missing packages:
+
+```bash
+Resolved 455 packages in 18.92s
+ × Failed to build `webrtcvad==2.0.10`
+ ├─▶ The build backend returned an error
+ ╰─▶ Call to `setuptools.build_meta:__legacy__.build_wheel` failed (exit status: 1)
+```
+
+To resolve this error, install the required build dependencies, and then retry the Langflow installation:
+
+```bash
+sudo apt-get update
+sudo apt-get install build-essential python3-dev
+```
+
+If upgrading your packages doesn't fix the issue, install `gcc` separately, and then retry the Langflow installation:
+
+```bash
+sudo apt-get install gcc
+```
+
+### Installation failure from `webrtcvad` package
+
+If you experience an error from the `webrtcvad` package, run `uv pip install webrtcvad-wheels` in your virtual environment, and then retry the Langflow installation.
+
+## Langflow startup issues
+
+The following issues can occur when attempting to start Langflow.
+
+### No `langflow.__main__` module
+
+When you try to run Langflow with the command `langflow run`, you encounter the following error:
+
+```bash
+> No module named 'langflow.__main__'
+```
+
+To resolve this issue, try the following:
+
+1. Run `uv run langflow run` instead of `langflow run`.
+2. If that doesn't work, reinstall the latest Langflow version with `uv pip install langflow -U`.
+3. If that doesn't work, reinstall Langflow and its dependencies with `uv pip install langflow --pre -U --force-reinstall`.
+
+### Langflow runTraceback
+
+When you try to run Langflow using the command `langflow run`, you encounter the following error:
+
+```bash
+> langflow runTraceback (most recent call last): File ".../langflow", line 5, in from langflow.__main__ import mainModuleNotFoundError: No module named 'langflow.__main__'
+```
+
+There are two possible reasons for this error:
+
+* **Multiple Langflow installations**: You installed Langflow using `pip install langflow` but you already had a previous version of Langflow installed in your system. In this case, you might be running the wrong executable.
+
+ To solve this issue, run the correct executable by running `python -m langflow run` instead of `langflow run`.
+
+ If that doesn't work, try uninstalling and reinstalling Langflow with `uv pip install langflow --pre -U`.
+
+* **Version conflict during installation**: Some version conflicts might have occurred during the installation process. To resolve this issue, reinstall Langflow and its dependencies by running `python -m pip install langflow --pre -U --force-reinstall`.
+
+## Langflow upgrade issues
+
+The following issues can occur when upgrading your Langflow version.
+
+For information about managing Langflow versions, see [Install Langflow](/get-started-installation).
+
+### Something went wrong running migrations
+
+The following error can occur during Langflow upgrades when the new version can't override `langflow-pre.db` in the Langflow cache folder:
+
+```bash
+> Something went wrong running migrations. Please, run 'langflow migration --fix'
+```
+
+To resolve this error, clear the cache by deleting the contents of the Langflow cache folder.
+
+:::important
+Clearing the cache erases your settings.
+If you want to retain your settings files, create a backup of those files before clearing the cache folder.
+:::
+
+The cache folder location depends on your OS:
+
+- **Linux**: `home//.cache/langflow/`
+- **WSL2 on Windows**: `home//.cache/langflow/`
+- **macOS**: `/Users//Library/Caches/langflow/`
+
+## MCP server issues
+
+- [Use MCP Inspector to test and debug flows](/mcp-server#test-and-debug-flows)
+- [Troubleshooting MCP server](/mcp-server#troubleshooting-mcp-server)
+
+## Custom components and integrations issues
+
+For troubleshooting advice for a third-party integration, see the information about that integration in the Langflow documentation and the provider's documentation.
+
+If you are building a custom component, see [Error handling and logging for custom Python components](/components-custom-components#error-handling-and-logging).
+
+## See also
+
+- [Langflow GitHub Issues and Discussions](/contributing-github-issues)
+- [Langflow telemetry](/contributing-telemetry)
\ No newline at end of file
diff --git a/docs/docusaurus.config.js b/docs/docusaurus.config.js
index a33587173..3d91ef4f7 100644
--- a/docs/docusaurus.config.js
+++ b/docs/docusaurus.config.js
@@ -277,6 +277,10 @@ const config = {
to: "/vector-store-rag",
from: "/starter-projects-vector-store-rag",
},
+ {
+ to: "/contributing-github-issues",
+ from: "/contributing-github-discussions",
+ },
// add more redirects like this
// {
// to: '/docs/anotherpage',
diff --git a/docs/sidebars.js b/docs/sidebars.js
index 0733a90dd..c109e5532 100644
--- a/docs/sidebars.js
+++ b/docs/sidebars.js
@@ -85,6 +85,7 @@ module.exports = {
"Configuration/configuration-custom-database",
"Configuration/configuration-global-variables",
"Configuration/environment-variables",
+ "Contributing/contributing-telemetry",
],
},
{
@@ -294,7 +295,7 @@ module.exports = {
},
{
type: "category",
- label: "Contributing",
+ label: "Contribute",
items: [
"Contributing/contributing-community",
"Contributing/contributing-how-to-contribute",
@@ -302,9 +303,6 @@ module.exports = {
"Contributing/contributing-component-tests",
"Contributing/contributing-templates",
"Contributing/contributing-bundles",
- "Contributing/contributing-github-discussion-board",
- "Contributing/contributing-github-issues",
- "Contributing/contributing-telemetry",
],
},
{
@@ -322,10 +320,20 @@ module.exports = {
type: "category",
label: "Support",
items: [
+ {
+ type: "doc",
+ id: "Support/troubleshooting",
+ label: "Troubleshoot",
+ },
+ {
+ type: "doc",
+ id: "Contributing/contributing-github-issues",
+ label: "Get help and request enhancements",
+ },
{
type: "doc",
id: "Support/luna-for-langflow",
- label: "Luna for Langflow",
+ label: "Enterprise support",
},
],
},