Retrieve physical disk serial numbers on Linux, Windows, and macOS.

This package is intentionally focused on storage serial retrieval only. It does not expose CPU IDs, MAC addresses, motherboard identifiers, or machine UUIDs.

• Node.js >= 18

npm install hddserial

const hddserial = require('hddserial');

(async () => {
  const serial = await hddserial.first();
  console.log(serial);
})();

const hddserial = require('hddserial');

hddserial.first((err, serial) => {
  if (err) return console.error(err);
  
  console.log(serial);
});

• first() -> returns first disk serial
• all() -> returns all detected serials
• one(index) -> returns serial at index
• check(serial) -> checks if serial exists

• Serial values are normalized to reduce OS-specific formatting noise.
• Results are deduplicated and returned in stable order.
• one(index) uses zero-based indexing.
• check(serial) compares normalized serial values.

• Disk serial availability depends on OS and permissions
• Some environments (Docker, VM, cloud) may not expose real disk serials
• macOS and certain SSDs may return limited or no serial information

• Linux
• Windows
• macOS

hddserial is validated in CI and real environments to ensure reliability across operating systems.

• Operating systems: Linux (ubuntu-latest), Windows (windows-latest), macOS (macos-latest)
• Node.js versions: 18, 20, 22
• Checks: npm ci, package entry validation, npm test, runtime smoke test (no crash), npm pack --dry-run

All CI matrix jobs are passing successfully.

• Windows 11 (physical machine): successfully retrieves disk serials and API behavior is verified
• Ubuntu 24.04 (Proxmox VM): installs and runs correctly, API executes without errors

• Disk serial availability depends on operating system permissions, hardware type, storage drivers, and virtualization environment
• Virtualized environments (for example Proxmox, KVM, Docker) may not expose real disk serials
• The library returns available disk/storage serials reported by the operating system

MIT