Files
firefrost-operations-manual/docs/tasks/nc1-node-usage-stats/deployment-plan.md
Claude dafb103119 feat: Add YAML frontmatter to all 57 task READMEs
Phase 1 of task management consolidation (per Gemini consultation).

Added standardized frontmatter with:
- status: open | blocked | complete
- priority: P1 | P2 | P3 | P4
- owner: Michael | Meg | Holly
- created: YYYY-MM-DD

Final counts:
- 39 open tasks
- 17 complete tasks
- 1 blocked task

Metadata extracted from existing inline markdown and audit results.
Ready for Phase 2: 11ty mobile index generation.

Chronicler #69
2026-04-08 14:21:41 +00:00

2.7 KiB

status, priority, owner, created
status priority owner created
open P3 Michael 2026-01-01

Task #44 — NC1 Node Usage Stats: Deployment Plan

Status: READY — installation steps documented Discovered: March 12, 2026 (Chronicler #29) Planned: Dedicated session required

Root Cause

NC1 node stats showing dashes in Pterodactyl panel (CPU, RAM, Disk, Swap, I/O, Network). Node Usage Status addon from Velta Studios requires custom Wings build to expose these metrics.

Solution

Install "Node Usage Status" addon (v1.0.2) — licensed via BuiltByBit. File already downloaded: NodeUsageStatus-v1.0.2.zip on Panel VPS at /var/www/pterodactyl/NodeUsageStatus-v1.0.2.zip Extracted to: /var/www/pterodactyl/NodeUsageStatus_extracted/

WARNING — Wings Recompile Required

This addon requires modifying Wings source code and rebuilding the binary. If the build fails, game servers lose their daemon connection. Do NOT attempt during a long session or when servers are active.

Part 1: Panel Installation

Step 1: Upload panel files

cd /var/www/pterodactyl/NodeUsageStatus_extracted/PanelFiles cp -r app/Http/Controllers/Admin/VeltaStudios /var/www/pterodactyl/app/Http/Controllers/Admin/ cp resources/views/admin/nodes/view/index.blade.php /var/www/pterodactyl/resources/views/admin/nodes/view/

Step 2: Modify routes/admin.php

Add the NodeStats route. Reference the HTML guide for exact location.

Step 3: Optimize panel

cd /var/www/pterodactyl php artisan optimize chown -R www-data:www-data /var/www/pterodactyl

Part 2: Wings Installation (TX1 + NC1 both)

Step 4.1: Download Wings source

WINGSDIR="/srv/wings" mkdir -p $WINGSDIR && cd $WINGSDIR Download latest Wings source zip from GitHub releases and unzip.

Step 4.2: Upload Wings addon files

Copy from Panel VPS extraction:

  • WingsFiles/router/router_node_stats.go -> Wings router directory
  • WingsFiles/system/metrics.go -> Wings system directory

Step 4.3: Modify router/router.go

Add node stats router include. Reference HTML guide for exact line.

Step 4.4: Install Go if not present

go version # check first

Step 4.5: Build and restart Wings

systemctl stop wings go build -o /usr/local/bin/wings chmod +x /usr/local/bin/wings systemctl start wings Build takes several minutes. Monitor carefully.

Files Location

  • Zip: /var/www/pterodactyl/NodeUsageStatus-v1.0.2.zip
  • Extracted: /var/www/pterodactyl/NodeUsageStatus_extracted/
  • HTML guide: /var/www/pterodactyl/NodeUsageStatus_extracted/Node Usage Status.html
  • BuiltByBit license: Active (purchased Jan 31, 2026)
  • Support: Velta Studios Discord

Session Requirements

  • Fresh session, not end of long day
  • TX1 and NC1 SSH ready
  • Plan 45-60 minutes
  • Low server activity before Wings restart
  • Backup Wings binary before recompile