{"record":{"id":"fee027ebd6d90407","repo":"quasarframework/quasar","slug":"network-error-encountered-while-following-the-quas","errorCode":null,"errorMessage":"Network error encountered while following the quasar.config file host/port config. Reconfigure and save the file again.","messagePattern":"Network error encountered while following the quasar\\.config file host/port config\\. Reconfigure and save the file again\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"app-vite/lib/quasar-config-file.js","lineNumber":1027,"sourceCode":"        cfg.devServer.host = this.#address.to.host\n        cfg.devServer.port = this.#address.to.port\n      } else {\n        const addr = {\n          host: cfg.devServer.host,\n          port: cfg.devServer.port\n        }\n        const to = this.#opts.verifyAddress\n          ? await onAddress(addr, this.#ctx.modeName)\n          : addr\n\n        // if network error while running\n        if (to === null) {\n          const msg =\n            'Network error encountered while following the quasar.config file host/port config.'\n\n          if (this.#shouldFail) fatal(msg, 'FAIL')\n\n          warn(msg + ' Reconfigure and save the file again.\\n')\n          return\n        }\n\n        cfg.devServer = merge({ open: true }, cfg.devServer, to)\n        this.#address = {\n          from: addr,\n          to: {\n            host: cfg.devServer.host,\n            port: cfg.devServer.port\n          }\n        }\n      }\n    }\n    // else for production:\n    else if (!Array.isArray(cfg.ssr.prodScriptNamedExport)) {\n      cfg.ssr.prodScriptNamedExport = cfg.ssr.prodScriptNamedExport\n        ? [cfg.ssr.prodScriptNamedExport]\n        : []","sourceCodeStart":1009,"sourceCodeEnd":1045,"githubUrl":"https://github.com/quasarframework/quasar/blob/4841521b5f635a971eb9e2710e5542efd194691b/app-vite/lib/quasar-config-file.js#L1009-L1045","documentation":"During config computation, onAddress verifies the configured devServer host/port; if it fails (bad host or no available port), it returns null and #computeConfig reports this network-error message. Fatal when shouldFail; otherwise it warns and aborts this config pass, prompting you to fix host/port and re-save (watch mode reloads the file).","triggerScenarios":"quasar.config > devServer > host names an address not present on any network interface (ERROR_NETWORK_ADDRESS_NOT_AVAIL), or no free port can be found from the configured starting port (ERROR_NETWORK_PORT_NOT_AVAIL), while opts.verifyAddress is active (dev run or config watch).","commonSituations":"Setting host to an external/VPN IP that is currently down or moved; typo in host (e.g. 'localhst'); all ports from the configured one upward are blocked; firewall/network change while the dev server watches the config file.","solutions":["Fix devServer.host in quasar.config — use 0.0.0.0, localhost, or a valid interface IP — and save to trigger re-computation.","Choose a lower/free devServer.port so findClosestOpenPort can find one.","Check network interfaces (ip addr / ifconfig) to confirm the host IP exists.","Restart `quasar dev` after fixing if file-watch didn't retrigger."],"exampleFix":"// before (quasar.config)\ndevServer: { host: '192.168.1.999', port: 65530 }\n// after\ndevServer: { host: '0.0.0.0', port: 9000 }","handlingStrategy":"validation","validationCode":"// Verify host exists on an interface before config save:\nimport { networkInterfaces } from 'node:os'\nconst host = cfg.devServer.host\nconst all = Object.values(networkInterfaces()).flat()\nif (host !== '0.0.0.0' && host !== 'localhost' && !all.some(n => n?.address === host)) {\n  console.warn(`Host ${host} not present on this machine`)\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Use 0.0.0.0 or localhost unless you need a specific interface.","Avoid pinning DHCP-assigned IPs in quasar.config; they change.","Choose a starting port well below 65535 so a free port can be found.","Re-check host/port after connecting to VPNs or switching networks."],"tags":["network","host","port","config"],"backgroundTag":"invalid-host-address","analyzedSha":"4841521b5f635a971eb9e2710e5542efd194691b","analyzedAt":"2026-08-30T01:13:14.944Z","schemaVersion":2},"datasetVersion":"2026-08-30T03:17:51.788Z"}