pengjunjie/langflow
1
0
Fork 1
mirror of https://github.com/langflow-ai/langflow.git synced 2026-07-23 22:15:24 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: troubleshooting for container mismatch (#13217)

Browse Source 
* add-troubleshooting-for-container-mismatch

* grep-for-volume-name

* fix-spacing

* danger-admonition
This commit is contained in:
Mendon Kissling
2026-05-27 14:40:16 -04:00
committed by GitHub
parent 9b7486efe8
commit e694bbcdff
1 changed files with 40 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
docs/docs/Support/troubleshooting.mdx
View File

@ -409,6 +409,46 @@ If you are the administrator, sign in with a superuser account, or restart Langf
For more information, see [Start Langflow Server with authentication enabled](/api-keys-and-authentication#start-a-langflow-server-with-authentication-enabled).
### PermissionError on `/app/langflow/secret_key` at startup
The Langflow container runs as a non-root user (`uid=1000`).
The Langflow image pre-creates `/app/langflow` with that user as the owner, so a new `langflow-data` named volume inherits the correct ownership.
If you ran an earlier image build that did not pre-create this directory, the named volume was initialized as `root:root` and the non-root container user cannot write `secret_key` into it, and the error `PermissionError: [Errno 13]` on `/app/langflow/secret_key` appears.
This commonly affects rootful Docker daemons such as Docker Desktop.
Podman with rootless user-namespace mapping does not reproduce the issue.
To preserve the `langflow-postgres` data while resetting only the `langflow-data` volume, do the following:
1. Stop the container and find the exact volume name for `langflow-data`.
This command lists the volumes, and then searches for `langflow-data`.
```sh
docker compose down
docker compose config --volumes
docker volume ls | grep langflow-data
```
2. Once you have confirmed the exact volume name, remove only that volume:
```sh
docker volume rm LANGFLOW_DATA_VOLUME_NAME
docker compose pull
docker compose up -d
```
Alternatively, if you don't need to preserve the `langflow-postgres` data volume, you can pull the latest container image instead.
:::danger
This method removes all data, including the `langflow-postgres` data volume.
:::
```sh
docker compose down -v
docker compose pull
docker compose up -d
```
## Langflow upgrade issues
The following issues can occur when upgrading your Langflow version.