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
85 lines
2.8 KiB
Markdown
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
|