Docker build hangs at web_server step during next build

[ellenlee]

🐛 Issue Summary

During self-hosted setup using docker-compose.dev.yml, the Docker build process gets stuck at the following step:

[web_server builder 5/5] RUN NODE_OPTIONS="${NODE_OPTIONS}" npx next build
=> => Retrying 1/3...
=> => Retrying 2/3...
=> => Retrying 3/3...

This step takes a very long time (over 15 minutes), and sometimes does not recover without manual interruption (e.g. Ctrl+C). It's unclear whether this is expected behavior, or if something is misconfigured.

---

📦 Expected Behavior

npx next build should finish within a reasonable time (2–5 minutes) or provide clearer logging to indicate progress or possible error.

---

🛠️ What I've Tried

• Restarting the build with --no-cache
• Increasing Docker memory limits
• Checking for lock files or corrupted cache (none found)
• Build was eventually successful after several retries and restarts, but it's hard to tell if it was supposed to take that long

---

🧪 Environment

OS: macOS 14.4 (Apple Silicon M1)
Docker: 28.0.1
Repo: https://github.com/onyx-dot-app/onyx
Branch: main (as of March 24, 2025)
Deploy method: docker-compose.dev.yml

[rkuo-danswer]

This isn't expected. The only thing I can think of is a connectivity issue here. It does take some time to build but we build many times a day consistently here.