Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com>
3.2 KiB
3.2 KiB
R630-04 Proxmox Troubleshooting Guide
Last Updated: 2026-01-31
Document Version: 1.0
Status: Active Documentation
IP Address: 192.168.11.14
Proxmox Version: 6.17.2-1-PVE
Issue: pveproxy worker exit (web interface not accessible on port 8006).
Problem Summary
- Proxmox VE is installed (version 6.17.2-1-PVE)
- SSH access works (port 22)
- Web interface not accessible (port 8006)
- pveproxy workers are crashing/exiting
Diagnostic Steps
1. Check pveproxy Service Status
systemctl status pveproxy --no-pager -l
Look for:
- Service state (should be "active (running)")
- Worker process exits
- Error messages
2. Check Recent Logs
journalctl -u pveproxy --no-pager -n 100
Look for:
- Worker exit messages
- Error patterns
- Stack traces
3. Check Port 8006
ss -tlnp | grep 8006
# or
netstat -tlnp | grep 8006
Should show pveproxy listening on port 8006.
4. Check Proxmox Cluster Status
pvecm status
If in a cluster, verify cluster connectivity.
Common Fixes
Fix 1: Restart pveproxy Service
systemctl restart pveproxy
systemctl status pveproxy
Fix 2: Check and Fix Configuration
# Check configuration files
ls -la /etc/pveproxy/
cat /etc/default/pveproxy 2>/dev/null
# Check for syntax errors
pveproxy --help
Fix 3: Reinstall pveproxy Package
apt update
apt install --reinstall pveproxy
systemctl restart pveproxy
Fix 4: Check for Port Conflicts
# Find what's using port 8006
ss -tlnp | grep 8006
lsof -i :8006
# If something else is using it, stop that service
Fix 5: Check Disk Space and Permissions
# Check disk space
df -h
# Check log directory permissions
ls -la /var/log/pveproxy/
# Should be owned by root:root with appropriate permissions
Fix 6: Check for Corrupted Database
# Check Proxmox database
pveversion -v
# Check cluster database (if in cluster)
systemctl status pve-cluster
Fix 7: Full Service Restart
# Restart all Proxmox services
systemctl restart pveproxy pvedaemon pvestatd pve-cluster
systemctl status pveproxy pvedaemon pvestatd pve-cluster
Advanced Troubleshooting
View Real-time Logs
journalctl -u pveproxy -f
Check Worker Process Details
# See running pveproxy processes
ps aux | grep pveproxy
# Check process limits
cat /proc/$(pgrep -f pveproxy | head -1)/limits
Test pveproxy Manually
# Stop service
systemctl stop pveproxy
# Try running manually to see errors
/usr/bin/pveproxy start
Scripts Available
- check-r630-04-commands.sh - Diagnostic commands
- fix-r630-04-pveproxy.sh - Automated fix script
Expected Resolution
After fixing:
systemctl status pveproxyshould show "active (running)"ss -tlnp | grep 8006should show pveproxy listening- Web interface should be accessible at
https://192.168.11.14:8006
Additional Resources
- Proxmox VE Documentation: https://pve.proxmox.com/pve-docs/
- Proxmox Forum: https://forum.proxmox.com/
- Log locations:
/var/log/pveproxy/access.log/var/log/pveproxy/error.logjournalctl -u pveproxy