Hot reload not working in Docker dev setup on Windows (WSL2) #1109

New Issue

MrUnknownDE · 2026-04-05T18:19:18+02:00

MrUnknownDE commented

2026-04-05 18:19:18 +02:00

Originally created by @Pallavikumarimdb on 8/6/2025

Description

When running the project on Windows, file changes in the local filesystem are not being detected properly, which causes issues with hot reload or other file-watching mechanisms.

Development Guide Says:

Environment

Host OS: Windows 10
WSL2/Docker Backend: Docker Desktop using WSL2
App running via docker-compose

Cause

The problem is with WSL2 or native file system watchers inside Docker containers on Windows hosts.

📝 Suggested Fix

Update the project's docker-compose.yml template or provide guidance in the Development Guide for Windows users to add the following environment variables:

- WATCHPACK_POLLING=true
- CHOKIDAR_USEPOLLING=true

It might slightly increase CPU usage, but for development only (not production), that’s fine.

*Originally created by @Pallavikumarimdb on 8/6/2025* ### Description When running the project on **Windows**, file changes in the local filesystem are not being detected properly, which causes issues with hot reload or other file-watching mechanisms. Development Guide Says: <img width="972" height="417" alt="Image" src="https://github.com/user-attachments/assets/3c72e759-baa0-47b8-9960-a6977361726b" /> ### Environment - **Host OS**: Windows 10 - **WSL2/Docker Backend**: Docker Desktop using WSL2 - App running via `docker-compose` ### Cause The problem is with WSL2 or native file system watchers inside Docker containers on Windows hosts. ### 📝 Suggested Fix Update the project's `docker-compose.yml` template or provide guidance in the Development Guide for Windows users to add the following environment variables: ```yaml - WATCHPACK_POLLING=true - CHOKIDAR_USEPOLLING=true ``` It might slightly increase CPU usage, but for development only (not production), that’s fine.

MrUnknownDE closed this issue

2026-04-05 18:19:18 +02:00

Sign in to join this conversation.

Branches Tags

main

dev

dependabot/npm_and_yarn/dev-minor-updates-b4e5d6b9c5

revert-2766-feature/systemd-install-instructions

dependabot/npm_and_yarn/prod-patch-updates-05702d39f2

dependabot/npm_and_yarn/next-16.2.1

dependabot/npm_and_yarn/recharts-3.8.1

alerting-rules

private-site-ha

dependabot/docker/docker/library/node-25-slim

ssh

delete-account

msg-delivery

org-only-idp

cicd

patch

site-targets-auto-login

No Label

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: github/pangolin#1109