Files
proxmox/docs/09-troubleshooting/R630-04-PROXMOX-TROUBLESHOOTING.md
defiQUG fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
docs: Ledger Live integration, contract deploy learnings, NEXT_STEPS updates
- 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>
2026-02-12 15:46:57 -08:00

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

  1. check-r630-04-commands.sh - Diagnostic commands
  2. fix-r630-04-pveproxy.sh - Automated fix script

Expected Resolution

After fixing:

  • systemctl status pveproxy should show "active (running)"
  • ss -tlnp | grep 8006 should show pveproxy listening
  • Web interface should be accessible at https://192.168.11.14:8006

Additional Resources