Files
firefrost-operations-manual/docs/tasks/nc1-node-usage-stats/deployment-plan.md
Claude b38f08189e feat: Add task_number to YAML frontmatter for 26 tasks
Long-term fix for mobile task index - task numbers now in frontmatter.

Numbers added from BACKLOG.md cross-reference:
#2 rank-system-deployment
#3 fire-frost-holdings-restructuring
#14 vaultwarden-ssh-setup
#22 netdata-deployment
#23 department-structure
#26 modpack-version-checker
#32 terraria-branding-training-arc
#35 pokerole-wikijs-deployment
#36 notebooklm-integration
#40 world-backup-automation
#44 nc1-node-usage-stats
#45 steam-and-state-server
#48 n8n-rebuild
#51 ignis-protocol
#55 discord-invite-setup
#65 claude-infrastructure-access
#67 nc1-security-monitoring
#82 plane-decommissioning
#87 arbiter-2-1-cancellation-flow
#89 staff-portal-consolidation
#90 decap-tasks-collection
#91 server-matrix-node-fix
#92 desktop-mcp
#93 trinity-codex
#94 global-restart-scheduler
#98 discord-channel-automation
#99 claude-projects-architecture

Chronicler #69
2026-04-08 14:32:38 +00:00

85 lines
2.8 KiB
Markdown

---
task_number: 44
status: open
priority: P3
owner: Michael
created: 2026-01-01
---
task_number: 44
# 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