v1.0.0

v1.0.0 - Stable Release

This is the stable release of version v1.0.0.

Status

This release is recommended for general use and production deployment.

What's New

• Real-time server monitoring dashboard (CPU, GPU, RAM, Disk, Network, Processes)
• CLI tool with background daemon support
• Dark/light mode toggle
• Live system data collection via OS APIs
• Cross-platform support (Windows, Linux, macOS)
• Pre-built UI bundled inside npm package
• Responsive single-page dashboard design

Installation / Usage

Clone Repository

Download the release assets below or clone the repository or npm package.

git clone https://github.com/ptkelanatechsolutions/serverstats.git

npm package

npm install -g serverstat
serverstat

Open http://localhost:3000 to view the dashboard.

Basic commands

serverstat                  # Start dashboard on localhost:3000
serverstat --port 8080      # Start on custom port
serverstat --host 0.0.0.0   # Bind to all interfaces
serverstat stop             # Stop the running daemon

Upgrade Notes

If you are upgrading from a pre-release version (alpha/beta), ensure no previous daemon is still running before upgrading:

serverstat stop
npm install -g serverstat@latest
serverstat

Notes

Thank you to everyone who tested the pre-release versions and reported issues.

Full Changelog: v1.0.0-alpha.3...v1.0.0

v1.0.0-alpha.3

v1.0.0-alpha.3 - Alpha Release

This is a pre-release version intended for testing, feedback, and early validation before the stable release.

Status

This release is not recommended for production use yet. Some features may still change, and bugs may still exist.

What's New

• Dual state file — state now written to both the app directory and os.tmpdir(), so serverstat stop works reliably even after npm upgrades or temp file cleanup
• Process name identification — daemon appears as serverstat-daemon in ps/htop/btop (via argv0), making it easy to identify and manage
• Graceful stop fallback — serverstat stop tries three strategies in sequence: state file → process name lookup (pgrep/tasklist) → helpful message
• Robust restart flow — clean separation between killDaemon() (kill without exit) and stopDaemon() (kill then exit) for reliable port/host changes

Changes

• State file format: plain PID file → JSON ({pid, port, host, version})
• State file location: single app/ → dual (app/ + os.tmpdir())
• Daemon process now spawns with argv0: "serverstat-daemon" for clear identification
• Refactored daemon kill logic into reusable killDaemon() / stopDaemon() functions

Bug Fixes

• Fixed serverstat stop failing when state file was deleted during npm upgrade
• Fixed process not found by name in ps aux | grep "next start" (process was spawned as node .../next start)
• Fixed port-probe false-positive when serverstat itself was already running
• Fixed restart path blocked by process.exit() in daemon kill
• Fixed corrupt/legacy state file causing startup errors (auto-cleanup + legacy .pid fallback)
• Fixed serverstat stop exit code after successful stop

Known Issues

• GPU auto-detection may not capture all metrics on all hardware
• CPU temperature requires admin privileges on some Windows systems
• Some features may not be fully stable yet

Installation / Usage

Download the release assets below or clone the repository using this tag.

git clone --branch v1.0.0-alpha.3 https://github.com/ptkelanatechsolutions/serverstats.git

Or install from npm:

npm install -g serverstat@1.0.0-alpha.3
serverstat

Notes

Please test this version carefully and report any bugs or unexpected behavior through GitHub Issues.

Full Changelog: v1.0.0-alpha.2...v1.0.0-alpha.3

v1.0.0-alpha.2

v1.0.0-alpha.2 - Alpha Release

This is a pre-release version intended for testing, feedback, and early validation before the stable release.

Status

This release is not recommended for production use yet. Some features may still change, and bugs may still exist.

What's New

• Running service detection: CLI now detects if serverstat is already running and shows connection info
• Auto-restart on config change: specifying --port or --host when already running stops the old instance and starts a new one
• JSON state file: replaced plain PID file with structured serverstat.json (pid, port, host, version)
• Refactored stop flow into reusable killDaemon / stopDaemon for reliable restart behavior
• Force-kill after timeout: daemon sends SIGKILL if SIGTERM doesn't stop within 4 seconds

Changes

• Improved error handling for running service detection
• Refactored CLI main flow for better maintainability
• Updated state file format from .pid to .json
• Enhanced help text with daemon behavior notes

Bug Fixes

• Fixed port-probe false-positive when serverstat itself was already running
• Fixed serverstat stop not exiting process after successful stop
• Fixed restart path where process.exit() in stopDaemon() prevented new server from starting
• Fixed corrupt PID file causing startup errors (auto-cleanup added)

Known Issues

• GPU auto-detection may not capture all metrics on all hardware
• CPU temperature requires admin privileges on some Windows systems
• Some features may not be fully stable yet

Installation / Usage

Download the release assets below or clone the repository using this tag.

git clone --branch v1.0.0-alpha.2 https://github.com/ptkelanatechsolutions/serverstats.git

Or install from npm:

npm install -g serverstat@1.0.0-alpha.2
serverstat

Notes

Please test this version carefully and report any bugs or unexpected behavior through GitHub Issues.

Full Changelog: v1.0.0-alpha.1...v1.0.0-alpha.2

v1.0.0-alpha.1

v1.0.0-alpha.1 - Pre-release

This is the first pre-release for version v1.0.0.

Status

This is an alpha pre-release. It is intended for early testing and feedback. Not recommended for production use.

What's New

• Initial alpha release
• Real-time server monitoring dashboard (CPU, GPU, RAM, Disk, Network, Processes)
• CLI tool with background daemon and serverstat stop command
• Dark/light mode support
• Live data collection via system APIs
• Pre-built UI bundled inside npm package

Installation

npm install -g serverstat@1.0.0-alpha.1
serverstat

How to Test

1. Install the package globally
2. Run serverstat
3. Open http://localhost:3000 in your browser
4. Verify all dashboard metrics load correctly
5. Run serverstat stop to stop the daemon

Known Issues

• This is an early pre-release. Some features may be incomplete.
• GPU auto-detection may not capture all metrics on all hardware
• CPU temperature requires admin privileges on some Windows systems

Feedback

Please report any issues or suggestions by creating a GitHub Issue.

Release Assets

• npm: serverstat@1.0.0-alpha.1 (tag: alpha)