Follow the Document Start with Local Source Code , pending on localhost:3000/install #7512

Closed
opened 2026-02-21 18:20:58 -05:00 by yindo · 1 comment
Owner

Originally created by @AnyangAngus on GitHub (Jan 3, 2025).

Self Checks

  • I have searched for existing issues search for existing issues, including closed ones.
  • I confirm that I am using English to submit report (我已阅读并同意 Language Policy).
  • [FOR CHINESE USERS] 请务必使用英文提交 Issue,否则会被关闭。谢谢!:)
  • Please do not modify this template :) and fill in all the required fields.

Provide a description of requested docs changes

I follow the deployment Document Start with Local Source Code strictly on a linux system.
It can start up with no error on docker-compose.middleware backend and frontend .
But on web-ui pending on localhost:3000/install.
1735902163318
How do I need to troubleshoot the problem?
Thank U!

Originally created by @AnyangAngus on GitHub (Jan 3, 2025). ### Self Checks - [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 report (我已阅读并同意 [Language Policy](https://github.com/langgenius/dify/issues/1542)). - [X] [FOR CHINESE USERS] 请务必使用英文提交 Issue,否则会被关闭。谢谢!:) - [X] Please do not modify this template :) and fill in all the required fields. ### Provide a description of requested docs changes I follow the deployment Document Start with Local Source Code strictly on a linux system. It can start up with no error on docker-compose.middleware backend and frontend . But on web-ui pending on localhost:3000/install. ![1735902163318](https://github.com/user-attachments/assets/77e8f497-68b8-4660-b390-3318ee605136) How do I need to troubleshoot the problem? Thank U!
yindo added the 🐞 bug label 2026-02-21 18:20:58 -05:00
yindo closed this issue 2026-02-21 18:20:58 -05:00
Author
Owner

@dosubot[bot] commented on GitHub (Jan 3, 2025):

Hey there, @AnyangAngus! 👋 I'm here to help you with bugs, questions, and becoming a contributor. If you need any assistance, feel free to ask!

I found similar discussions that might be relevant to your issue:

  1. Help Problem starting the project - This discussion is open but unsolved [1].
  2. I can't reach localhost/install after deploying the docker - This discussion is also open and unsolved [2].

To troubleshoot the issue of the web UI being stuck on localhost:3000/install, ensure the following:

  1. Environment Variables: Check the .env.local file in the web directory. Ensure NEXT_PUBLIC_API_PREFIX and NEXT_PUBLIC_PUBLIC_API_PREFIX are set to http://localhost:5001/console/api and http://localhost:5001/api, respectively.

  2. API Server: Verify the API server is running on port 5001 with the command:

    flask run --host 0.0.0.0 --port=5001 --debug
    
  3. Frontend Build and Start: Confirm the frontend service is built and started correctly:

    npm run build
    npm run start
    
  4. Dependencies: Ensure all dependencies are installed using npm install in the web directory.

  5. CORS Configuration: Check for CORS errors and update the configuration in your environment or docker-compose.yml to match your domain.

  6. Prerequisites: Ensure your system meets the minimum requirements: CPU >= 2 Core and RAM >= 4 GiB. Verify necessary software like Docker and Docker Compose is installed.

  7. Database and Middleware Services: Ensure PostgreSQL, Redis, and Weaviate are running. Start them with:

    cd docker
    docker compose -f docker-compose.middleware.yaml up -d
    

If the issue persists, check the console logs for errors in both frontend and backend services [3][4].

To continue talking to Dosu, mention @dosu.


Help Dosu learn! Give it feedback: Great Response | Irrelevant Answer | Incorrect Sources | Too Verbose | Hallucination | Other

@dosubot[bot] commented on GitHub (Jan 3, 2025): <!-- Greeting --> Hey there, @AnyangAngus! 👋 I'm here to help you with bugs, questions, and becoming a contributor. If you need any assistance, feel free to ask! <!-- Answer --> I found similar discussions that might be relevant to your issue: 1. [Help Problem starting the project](https://github.com/langgenius/dify/discussions/9751) - This discussion is open but unsolved <sup>[[1]](https://github.com/langgenius/dify/discussions/9751)</sup>. 2. [I can't reach localhost/install after deploying the docker](https://github.com/langgenius/dify/discussions/5746) - This discussion is also open and unsolved <sup>[[2]](https://github.com/langgenius/dify/discussions/5746)</sup>. To troubleshoot the issue of the web UI being stuck on `localhost:3000/install`, ensure the following: 1. **Environment Variables**: Check the `.env.local` file in the `web` directory. Ensure `NEXT_PUBLIC_API_PREFIX` and `NEXT_PUBLIC_PUBLIC_API_PREFIX` are set to `http://localhost:5001/console/api` and `http://localhost:5001/api`, respectively. 2. **API Server**: Verify the API server is running on port 5001 with the command: ```bash flask run --host 0.0.0.0 --port=5001 --debug ``` 3. **Frontend Build and Start**: Confirm the frontend service is built and started correctly: ```bash npm run build npm run start ``` 4. **Dependencies**: Ensure all dependencies are installed using `npm install` in the `web` directory. 5. **CORS Configuration**: Check for CORS errors and update the configuration in your environment or `docker-compose.yml` to match your domain. 6. **Prerequisites**: Ensure your system meets the minimum requirements: CPU >= 2 Core and RAM >= 4 GiB. Verify necessary software like Docker and Docker Compose is installed. 7. **Database and Middleware Services**: Ensure PostgreSQL, Redis, and Weaviate are running. Start them with: ```bash cd docker docker compose -f docker-compose.middleware.yaml up -d ``` If the issue persists, check the console logs for errors in both frontend and backend services <sup>[[3]](https://github.com/langgenius/dify-docs/blob/main/en/getting-started/install-self-hosted/local-source-code.md)</sup><sup>[[4]](https://github.com/langgenius/dify-docs/blob/main/en/learn-more/faq/install-faq.md)</sup>. <!-- Dosu Comment Footer --> *To continue talking to [Dosu](https://dosu.dev), mention @dosu.* --- <sup>Help Dosu learn! Give it feedback: [Great Response](https://app.dosu.dev/response-feedback/66c49c4a-595f-485d-9429-35b2a26a967d?feedback_type=great_response) | [Irrelevant Answer](https://app.dosu.dev/response-feedback/66c49c4a-595f-485d-9429-35b2a26a967d?feedback_type=irrelevant_answer) | [Incorrect Sources](https://app.dosu.dev/response-feedback/66c49c4a-595f-485d-9429-35b2a26a967d?feedback_type=incorrect_sources) | [Too Verbose](https://app.dosu.dev/response-feedback/66c49c4a-595f-485d-9429-35b2a26a967d?feedback_type=too_verbose) | [Hallucination](https://app.dosu.dev/response-feedback/66c49c4a-595f-485d-9429-35b2a26a967d?feedback_type=hallucination) | [Other](https://app.dosu.dev/response-feedback/66c49c4a-595f-485d-9429-35b2a26a967d?feedback_type=other)</sup>
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: langgenius/dify#7512