langgenius/dify
1
0
Fork 0
mirror of https://github.com/langgenius/dify.git synced 2026-07-21 12:05:30 -04:00
Code Issues 775 Packages Projects Releases 10 Wiki Activity

The API service fails to start on the local Windows system. #20269

New Issue
Closed
opened 2026-02-21 20:06:35 -05:00 by yindo · 2 comments
yindo commented 2026-02-21 20:06:35 -05:00
Owner
Copy Link
Copy Source

Originally created by @yingjoumong8 on GitHub (Nov 12, 2025).

Self Checks

  • I have read the Contributing Guide and Language Policy.
  • This is only for bug report, if you would like to ask a question, please head to Discussions.
  • I have searched for existing issues search for existing issues, including closed ones.
  • I confirm that I am using English to submit this report, otherwise it will be closed.
  • 【中文用户 & Non English User】请使用英语提交，否则会被关闭 ：）
  • Please do not modify this template :) and fill in all the required fields.

Dify version

1.9.2

Cloud or Self Hosted

Self Hosted (Source)

Steps to reproduce

Image F:\gitWeb\dify-1.9.2\api>uv run flask run --host 0.0.0.0 --port=5001 --debug 2025-11-12 02:46:04,598 INFO [utils.py:164] NumExpr defaulting to 16 threads.

For the first time, when the source code was initiated following the official documentation for deployment, there was no response. The connection to the PostgreSQL database appears to be functioning without issue.

✔️ Expected Behavior

Start as usual.

❌ Actual Behavior

No response

Originally created by @yingjoumong8 on GitHub (Nov 12, 2025). ### Self Checks - [x] I have read the [Contributing Guide](https://github.com/langgenius/dify/blob/main/CONTRIBUTING.md) and [Language Policy](https://github.com/langgenius/dify/issues/1542). - [x] This is only for bug report, if you would like to ask a question, please head to [Discussions](https://github.com/langgenius/dify/discussions/categories/general). - [x] I have searched for existing issues [search for existing issues](https://github.com/langgenius/dify/issues), including closed ones. - [x] I confirm that I am using English to submit this report, otherwise it will be closed. - [x] 【中文用户 & Non English User】请使用英语提交，否则会被关闭 ：） - [x] Please do not modify this template :) and fill in all the required fields. ### Dify version 1.9.2 ### Cloud or Self Hosted Self Hosted (Source) ### Steps to reproduce <img width="900" height="112" alt="Image" src="https://github.com/user-attachments/assets/f6cfdb94-0336-4f60-9984-e20ebfd91b01" /> F:\gitWeb\dify-1.9.2\api>uv run flask run --host 0.0.0.0 --port=5001 --debug 2025-11-12 02:46:04,598 INFO [utils.py:164] NumExpr defaulting to 16 threads. For the first time, when the source code was initiated following the official documentation for deployment, there was no response. The connection to the PostgreSQL database appears to be functioning without issue. ### ✔️ Expected Behavior Start as usual. ### ❌ Actual Behavior No response
yindo added the 🐞 bug label 2026-02-21 20:06:35 -05:00
yindo closed this issue 2026-02-21 20:06:35 -05:00
yindo commented 2026-02-21 20:06:35 -05:00
Author
Owner
Copy Link
Copy Source

@dosubot[bot] commented on GitHub (Nov 12, 2025):

Hi @yingjoumong8! I'm Dosu and I’m helping the dify team.

There are known Windows compatibility issues with Dify's startup scripts and server commands. The main API entry point uses Flask's built-in development server (app.run(host="0.0.0.0", port=5001)), which should work on Windows, but platform-specific problems can occur if dependencies or environment variables are missing or misconfigured.

A recent fix addressed Windows startup failures caused by Unix-specific commands in the start script. If you are running the web frontend, make sure you use the new Node.js script (copy-and-start.mjs) instead of commands like cp that don't work on Windows. This script copies required static files and starts the server in a cross-platform way details here.

For the API service, double-check that all Python dependencies are installed and compatible with Windows, and that you are using the correct command (python app.py or flask run --host 0.0.0.0 --port=5001) in the api directory. Avoid using Unix-specific shell commands or relying on Docker networking unless you are running inside WSL2 or a compatible environment.

If you still see "no response," check for error logs beyond the NumExpr info, verify the port is open with netstat, and confirm that firewall or antivirus software is not blocking the process. If you have more error output, sharing it could help pinpoint the issue.

To reply, just mention @dosu.

How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other  Chat with Dosu Join Discord Share on X

@dosubot[bot] commented on GitHub (Nov 12, 2025): <!-- Greeting --> Hi @yingjoumong8! I'm [Dosu](https://go.dosu.dev/dosubot) and I’m helping the dify team. <!-- Answer --> There are known Windows compatibility issues with Dify's startup scripts and server commands. The main API entry point uses Flask's built-in development server (`app.run(host="0.0.0.0", port=5001)`), which should work on Windows, but platform-specific problems can occur if dependencies or environment variables are missing or misconfigured. A recent fix addressed Windows startup failures caused by Unix-specific commands in the start script. If you are running the web frontend, make sure you use the new Node.js script (`copy-and-start.mjs`) instead of commands like `cp` that don't work on Windows. This script copies required static files and starts the server in a cross-platform way [details here](https://github.com/langgenius/dify/pull/25672). For the API service, double-check that all Python dependencies are installed and compatible with Windows, and that you are using the correct command (`python app.py` or `flask run --host 0.0.0.0 --port=5001`) in the `api` directory. Avoid using Unix-specific shell commands or relying on Docker networking unless you are running inside WSL2 or a compatible environment. If you still see "no response," check for error logs beyond the NumExpr info, verify the port is open with `netstat`, and confirm that firewall or antivirus software is not blocking the process. If you have more error output, sharing it could help pinpoint the issue. <!-- Dosu Comment Footer --> *To reply, just mention [@dosu](https://go.dosu.dev/dosubot).* --- <sup>How did I do? [Good](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=great_response) | [Irrelevant](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=irrelevant_answer) | [Incorrect](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=incorrect_sources) | [Verbose](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=hallucination) | [Report 🐛](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=bug_report) | [Other](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=other)</sup>&nbsp;&nbsp;[![Chat with Dosu](https://dosu.dev/dosu-chat-badge.svg)](https://app.dosu.dev/6088a4f4-073a-43f3-b3d4-4f06fb0c05a0/ask?utm_source=github)&nbsp;[![Join Discord](https://img.shields.io/badge/join-5865F2?logo=discord&logoColor=white&label=)](https://go.dosu.dev/discord-bot)&nbsp;[![Share on X](https://img.shields.io/badge/X-share-black)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/langgenius/dify/issues/28108)
yindo commented 2026-02-21 20:06:35 -05:00
Author
Owner
Copy Link
Copy Source

@Hai5206 commented on GitHub (Nov 17, 2025):

嗨 ！我是 Dosu，我正在帮助 dify 团队。

Dify 的启动脚本和服务器命令存在已知的 Windows 兼容性问题。主要 API 入口点使用 Flask 的内置开发服务器 （），它应该可以在 Windows 上运行，但如果依赖项或环境变量丢失或配置错误，则可能会出现特定于平台的问题。app.run(host="0.0.0.0", port=5001)

最近的修复解决了由启动脚本中特定于 Unix 的命令导致的 Windows 启动失败。如果您正在运行 Web 前端，请确保使用新的 Node.js 脚本 （） 而不是在 Windows 上不起作用的命令。此脚本复制所需的静态文件并以跨平台方式启动服务器，详见此处。copy-and-start.mjs``cp

对于 API 服务，请仔细检查是否已安装所有 Python 依赖项并与 Windows 兼容，以及目录中使用了正确的命令（ 或 ）。避免使用特定于 Unix 的 shell 命令或依赖 Docker 网络，除非您在 WSL2 或兼容环境中运行。python app.py``flask run --host 0.0.0.0 --port=5001``api

如果您仍然看到“无响应”，请检查 NumExpr 信息之外的错误日志，验证端口是否打开，并确认防火墙或防病毒软件没有阻止该进程。如果您有更多错误输出，共享它可以帮助查明问题。netstat

要回复，只需提及@dosu。

我表现得怎么样？很好 |无关紧要 |错误 |冗长 |幻觉 |报告 🐛 |其他  与Dosu聊天 加入Discord 分享到X平台

我就是在这个前后端全部跑通之后到了注册页面，但是始终注册不了，会是报一些这样的错误，麻烦有时间可以答复下

Image
@Hai5206 commented on GitHub (Nov 17, 2025): > 嗨 ！我是 [Dosu](https://go.dosu.dev/dosubot)，我正在帮助 dify 团队。 > > Dify 的启动脚本和服务器命令存在已知的 Windows 兼容性问题。主要 API 入口点使用 Flask 的内置开发服务器 （），它应该可以在 Windows 上运行，但如果依赖项或环境变量丢失或配置错误，则可能会出现特定于平台的问题。`app.run(host="0.0.0.0", port=5001)` > > 最近的修复解决了由启动脚本中特定于 Unix 的命令导致的 Windows 启动失败。如果您正在运行 Web 前端，请确保使用新的 Node.js 脚本 （） 而不是在 Windows 上不起作用的命令。此脚本复制所需的静态文件并以跨平台方式启动服务器，[详见此处](https://github.com/langgenius/dify/pull/25672)。`copy-and-start.mjs``cp` > > 对于 API 服务，请仔细检查是否已安装所有 Python 依赖项并与 Windows 兼容，以及目录中使用了正确的命令（ 或 ）。避免使用特定于 Unix 的 shell 命令或依赖 Docker 网络，除非您在 WSL2 或兼容环境中运行。`python app.py``flask run --host 0.0.0.0 --port=5001``api` > > 如果您仍然看到“无响应”，请检查 NumExpr 信息之外的错误日志，验证端口是否打开，并确认防火墙或防病毒软件没有阻止该进程。如果您有更多错误输出，共享它可以帮助查明问题。`netstat` > > _要回复，只需提及[@dosu](https://go.dosu.dev/dosubot)。_ > > 我表现得怎么样？[很好](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=great_response) |[无关紧要](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=irrelevant_answer) |[错误](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=incorrect_sources) |[冗长](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=too_verbose) |[幻觉](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=hallucination) |[报告 🐛](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=bug_report) |[其他](https://app.dosu.dev/response-feedback/ec98137d-4872-40c1-afc0-1846d670e103?feedback_type=other)  [![与Dosu聊天](https://camo.githubusercontent.com/7c571478962a6b8a5d47cac74b6824c75e4f6731bba52377e6007f9150462923/68747470733a2f2f646f73752e6465762f646f73752d636861742d62616467652e737667)](https://app.dosu.dev/6088a4f4-073a-43f3-b3d4-4f06fb0c05a0/ask?utm_source=github) [![加入Discord](https://camo.githubusercontent.com/7d2066700925db1e370d956834f9ea0e5bc92cecbe84963fbd2a363e45091b4e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6a6f696e2d3538363546323f6c6f676f3d646973636f7264266c6f676f436f6c6f723d7768697465266c6162656c3d)](https://go.dosu.dev/discord-bot) [![分享到X平台](https://camo.githubusercontent.com/a8bd7f3fcf3f5e3bd124eee9ae50ae2ac17b40971726665ac2121d48f9aee155/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f582d73686172652d626c61636b)](https://twitter.com/intent/tweet?text=%40dosu_ai%20helped%20me%20solve%20this%20issue!&url=https%3A//github.com/langgenius/dify/issues/28108) 我就是在这个前后端全部跑通之后到了注册页面，但是始终注册不了，会是报一些这样的错误，麻烦有时间可以答复下 <img width="1087" height="347" alt="Image" src="https://github.com/user-attachments/assets/dc3032de-414d-4f21-b231-8ccdc791998e" />
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
Knowledge Pipeline
Proposal
WIP
cloud
dependencies
feat:webapp
good first issue
outdated
performance
pull-request
Mirrored from GitHub Pull Request
 python:uv
refactor
size:L
stale
status: accepting prs
status: blocked
status: in discussion
stt & tts
vulnerablity
web
wont-fix
🌊 feat:workflow
🌚 invalid
🐞 bug
👻 feat:rag
💪 enhancement
📚 documentation
🔨 feat:tools
🙋‍♂️ question
🙏 help wanted
🤔 cant-reproduce
🤖 feat:agent
No Label 🐞 bug
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
yindo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langgenius/dify#20269
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?