Software⏱️ 2 min read📅 2026-05-29

How to Fix: Liferay Workspace runs npm with --network-timeout flag and fails with 404 (

Quick Answer: Try setting the npm timeout to a higher value, e.g. `npm config set max-timeout 30000` or update your Liferay configuration to use yarn instead of npm.

Liferay Workspace runs npm with the --network-timeout flag and fails with a 404 error, interpreting the timeout as a package issue. This occurs when the network connection is slow or unstable, causing npm to time out while trying to fetch dependencies.

🔧 Proven Troubleshooting Steps

Method 1: Adjusting Network Timeout

  1. Step 1: Open the Liferay DXP console and navigate to Configuration > Build Settings.

Method 2: Setting up a Proxy Server

  1. Step 1: Install a proxy server software like NGINX or Apache.

💡 Conclusion

By following these steps, you should be able to resolve the npm timeout issue and successfully build your Liferay Workspace project.

Did this fix your problem?

If not, try searching for specific error codes.

🔍 Search Error Database

❓ Frequently Asked Questions