ip-report

library0.0.45jsnpmunverified

Node.js WebSocket client that periodically reports machine name and IP address to a server every 10 seconds. Current stable version is 0.0.45. Published with low release cadence. Key differentiators: lightweight, no build steps, runs via npx, supports Windows/Linux/macOS, and automatically installs Electron 28+ as a dependency for desktop notifications. Primarily used for machine monitoring or asset tracking in local networks.

devops

npm install ip-report

package ↗

INSTALL

IMPORT

SIG · IP-REPORT

ip-report

devopsjavascriptv0.0.45

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default (running as script)

✓ npx ip-report

✗ require('ip-report')

ip-report is primarily a CLI tool, not a library. Use npx or global install.

setClientName (if exposed)

✓ const ipReport = require('ip-report'); if (ipReport.setClientName) ipReport.setClientName('MyMachine')

✗ import { setClientName } from 'ip-report'

No documented exports; package likely only exposes a CLI. Assume no imports.

Runs the ip-report client with a custom machine name, connecting to default WebSocket server.

CLIENT_NAME='my-server' npx ip-report@0.0.45

Debug

Known issues

breakingNode.js 18+ required. Older Node.js versions will fail.

fix

Update Node.js to version 18 or higher.

affects: <0.0.45

gotchaElectron auto-install may fail in headless environments or restricted CI systems.

fix

Set ELECTRON_SKIP_PLATFORM_CHECK=1 or install electron globally beforehand.

affects: >=0.0.1

gotchaThe default WebSocket server (wss://li.feng3d.com) may be down or untrusted for production use.

fix

Configure a custom server URL via environment variable SERVER_URL if available.

affects: >=0.0.1

breakingNo SemVer guarantee; version 0.0.x may break at any time.

fix

Pin to exact version in scripts.

affects: >=0.0.1

Errors

Common errors & fixes

Error: The engine "node" is incompatible with this module. Expected version ">=18". Got "16.x"

Node.js version below minimum requirement.

fix

Upgrade Node.js to 18+ or use nvm to switch version.

Error: Cannot find module 'electron'

Electron dependency not installed (optional but needed for some features).

fix

Run `npm install electron` or set ELECTRON_SKIP_PLATFORM_CHECK=true if not needed.

WebSocket connection to 'wss://li.feng3d.com/' failed: Error: connect ECONNREFUSED

Default server is unreachable or misconfigured.

fix

Ensure you have network access to the server, or configure a custom endpoint.

npx: installed 1 in 2.084s Error: Unsupported platform: win32-x64 not in ['linux-x64','darwin-x64']

Package contains native modules or Electron binaries not compatible with your OS/arch.

fix

Check that your OS is supported (Windows/Linux/macOS) and architecture is x64.

Upgrade

Version history

0.0.45latest on npm

Audit

Dependencies

electronoptionalRequired for desktop notification support

Agent activity

6 hits · last 30 days

node

Resources

packageip-report ↗