{"record":{"id":"06062c861c597b81","repo":"quasarframework/quasar","slug":"unknown-network-error-occurred","errorCode":null,"errorMessage":"Unknown network error occurred","messagePattern":"Unknown network error occurred","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"app-vite/lib/quasar-config-file.js","lineNumber":275,"sourceCode":"      warn()\n      warn(`️️Setting port to closest one available: ${openPort}`)\n      warn()\n\n      port = openPort\n    }\n  } catch (err) {\n    warn()\n\n    if (err.message === 'ERROR_NETWORK_PORT_NOT_AVAIL') {\n      warn(\n        'Could not find an open port. Please configure a lower one to start searching with.'\n      )\n    } else if (err.message === 'ERROR_NETWORK_ADDRESS_NOT_AVAIL') {\n      warn(\n        'Invalid host specified. No network address matches. Please specify another one.'\n      )\n    } else {\n      warn('Unknown network error occurred')\n      console.error(err)\n    }\n\n    warn()\n\n    if (!addressRunning) process.exit(1)\n    return null\n  }\n\n  addressRunning = true\n  return { host, port }\n}\n\nlet wsToken = null\nfunction createWsToken() {\n  if (wsToken === null) {\n    const list =\n      'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'","sourceCodeStart":257,"sourceCodeEnd":293,"githubUrl":"https://github.com/quasarframework/quasar/blob/4841521b5f635a971eb9e2710e5542efd194691b/app-vite/lib/quasar-config-file.js#L257-L293","documentation":"This is the catch-all branch of the network-error handler in QuasarConfigFile#onAddress. The address/port detection helper rejected with something other than the two recognized codes (ERROR_NETWORK_PORT_NOT_AVAIL / ERROR_NETWORK_ADDRESS_NOT_AVAIL), so the cause is unknown; the original error is printed via console.error and the process exits if no address resolution is running.","triggerScenarios":"Any rejection from the underlying get-network-addresses/port detection utilities that is not one of the two known error codes — e.g. an unexpected OS-level network API failure, an EPERM/EACCES from a socket call, or an internal bug in the detection helper surfaced while resolving devServer.host during `quasar dev`.","commonSituations":"Running inside restricted sandboxes/containers where socket or interface enumeration is blocked; broken or missing network interfaces in CI; VPN/proxy software interfering with address detection; Node version changes altering API behavior of network detection.","solutions":["Read the stack trace printed below the warning — it names the actual underlying error","Check devServer.host in quasar.config and try a concrete value like '127.0.0.1' or '0.0.0.0' instead of a hostname","Verify the machine has a usable non-loopback network interface (`ip addr` / `ifconfig`); fix or restore it","Try running with a simplified network environment (disable VPN/proxy) or a newer/patched Node LTS version","If it reproduces on a clean project, report it to the Quasar team with the full stack"],"exampleFix":"// before (quasar.config.js)\ndevServer: { server: { host: 'my-laptop.local' } }\n// after\ndevServer: { server: { host: '127.0.0.1' } }","handlingStrategy":"validation","validationCode":"const os = require('node:os')\nconst nets = os.networkInterfaces()\nconst hasUsableAddress = Object.values(nets)\n  .flat()\n  .some(n => n && !n.internal && n.family === 'IPv4')\nif (!hasUsableAddress) {\n  console.warn('No usable network interface; pin devServer.server.host to 127.0.0.1')\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Pin devServer.server.host to a concrete value (127.0.0.1 or 0.0.0.0) in restricted environments instead of relying on auto-detection","Ensure containers/CI sandboxes allow socket and interface enumeration","Keep Node updated to a current LTS to avoid network API behavior changes","When this fires, always read the console.error stack — it names the real underlying failure"],"tags":["network","dev-server","unknown-error","quasar-config"],"backgroundTag":"network-address-detection-failed","analyzedSha":"4841521b5f635a971eb9e2710e5542efd194691b","analyzedAt":"2026-08-30T01:13:14.944Z","schemaVersion":2},"datasetVersion":"2026-08-30T03:17:51.788Z"}