Lovable deployment

Vite Hot Module Replacement (HMR) Connection Fails

Vite dev server starts but HMR connection fails with 'WebSocket connection failed' or 'net::ERR_CONNECTION_REFUSED'. Changes require manual page refresh instead of hot reload. Development experience is slow.

HMR requires WebSocket connection from browser to dev server. Network configuration or firewall can block the connection.

Error Messages You Might See

WebSocket connection failed net::ERR_CONNECTION_REFUSED HMR connection timed out
WebSocket connection failednet::ERR_CONNECTION_REFUSEDHMR connection timed out

Common Causes

  1. Dev server not on correct host/port
  2. WebSocket connection blocked by firewall/proxy
  3. HMR host not configured for remote dev
  4. HTTPS in production with HTTP dev server mismatch
  5. Port not exposed in container/VM environment

How to Fix It

Configure HMR in vite.config.js for remote dev:

export default {
  server: {
    hmr: {
      host: 'localhost',
      port: 5173,
      protocol: 'ws'
    }
  }
}

For remote development (Docker, VM):

hmr: {
  host: 'your-dev-server.com',
  port: 443,
  protocol: 'wss'
}

Real developers can help you.

Yovel Cohen Yovel Cohen I got a lot of experience in building Long-horizon AI Agents in production, Backend apps that scale to millions of users and frontend knowledge as well. Daniel Vázquez Daniel Vázquez Software Engineer with over 10 years of experience on Startups, Government, big tech industry & consulting. Bastien Labelle Bastien Labelle Full stack dev w/ 20+ years of experience Matt Butler Matt Butler Software Engineer @ AWS Rudra Bhikadiya Rudra Bhikadiya I build and fix web apps across Next.js, Node.js, and DBs. Comfortable jumping into messy code, broken APIs, and mysterious bugs. If your project works in theory but not in reality, I help close that gap. MFox MFox Full-stack professional senior engineer (15+years). Extensive experience in software development, qa, and IP networking. Pratik Pratik SWE with 15+ years of experience building and maintaining web apps and extensive BE infrastructure Richard McSorley Richard McSorley Full-Stack Software Engineer with 8+ years building high-performance applications for enterprise clients. Shipped production systems at Walmart (4,000+ stores), Cigna (20M+ users), and Arkansas Blue Cross. 5 patents in retail/supply chain tech. Currently focused on AI integrations, automation tools, and TypeScript-first architectures. rayush33 rayush33 JavaScript (React.js, React Native, Node.js) Developer with demonstrated industry experience of 4+ years, actively looking for opportunities to hone my skills as well as help small-scale business owners with solutions to technical problems Taufan Taufan I’m a product-focused engineer and tech leader who builds scalable systems and turns ideas into production-ready platforms. Over the past years, I’ve worked across startups and fast-moving teams, leading backend architecture, improving system reliability, and shipping products used by thousands of users. My strength is not just writing code — but connecting product vision, technical execution, and business impact.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help

Frequently Asked Questions

How do I debug HMR issues?

Check browser DevTools Network tab for WebSocket connection. Look for connection to /__vite_ping endpoint.

What port does HMR use?

Same as dev server by default (usually 5173). Can be configured separately for remote development.

Related Lovable Issues

Can't fix it yourself?
Real developers can help.

You don't need to be technical. Just describe what's wrong and a verified developer will handle the rest.

Get Help