Files
proxmox/docs/09-troubleshooting/TROUBLESHOOT_CONNECTION.md
defiQUG cb47cce074 Complete markdown files cleanup and organization
- Organized 252 files across project
- Root directory: 187 → 2 files (98.9% reduction)
- Moved configuration guides to docs/04-configuration/
- Moved troubleshooting guides to docs/09-troubleshooting/
- Moved quick start guides to docs/01-getting-started/
- Moved reports to reports/ directory
- Archived temporary files
- Generated comprehensive reports and documentation
- Created maintenance scripts and guides

All files organized according to established standards.
2026-01-06 01:46:25 -08:00

122 lines
2.7 KiB
Markdown

# Troubleshooting Proxmox Connection
## Current Issue
The Proxmox host `192.168.11.10` is not reachable from this machine.
## Diagnosis Results
-**Ping Test**: 100% packet loss (host unreachable)
-**Port 8006**: Not accessible
-**Configuration**: Loaded correctly from `~/.env`
## Possible Causes
1. **Network Connectivity**
- Host is on a different network segment
- VPN not connected
- Network routing issue
- Host is powered off
2. **Firewall**
- Firewall blocking port 8006
- Network firewall rules
3. **Wrong Host Address**
- Host IP may have changed
- Host may be on different network
## Troubleshooting Steps
### 1. Check Network Connectivity
```bash
# Test basic connectivity
ping -c 3 192.168.11.10
# Check if host is on same network
ip route | grep 192.168.11.0
```
### 2. Check Alternative Hosts
If you have access to other Proxmox hosts, try:
```bash
# Test connectivity to alternative hosts
ping -c 3 <alternative-proxmox-host>
```
### 3. Use Shell Script (SSH Alternative)
If you have SSH access to the Proxmox node, use the shell script instead:
```bash
export PROXMOX_HOST=192.168.11.10
export PROXMOX_USER=root
./list_vms.sh
```
The shell script uses SSH which may work even if the API port is blocked.
### 4. Check VPN/Network Access
If the Proxmox host is on a remote network:
- Ensure VPN is connected
- Verify network routing
- Check if you're on the correct network segment
### 5. Verify Host is Running
- Check if Proxmox host is powered on
- Verify Proxmox services are running
- Check Proxmox web interface accessibility
### 6. Test from Proxmox Host Itself
If you can access the Proxmox host directly:
```bash
# SSH to Proxmox host
ssh root@192.168.11.10
# Test API locally
curl -k https://localhost:8006/api2/json/version
```
## Alternative: Use Shell Script
The shell script (`list_vms.sh`) uses SSH instead of the API, which may work even if:
- API port is blocked
- You're on a different network
- VPN provides SSH access but not API access
```bash
export PROXMOX_HOST=192.168.11.10
export PROXMOX_USER=root
./list_vms.sh
```
## Next Steps
1. **If host is accessible via SSH**: Use `list_vms.sh`
2. **If host is on different network**: Connect VPN or update network routing
3. **If host IP changed**: Update `PROXMOX_HOST` in `~/.env`
4. **If host is down**: Wait for it to come back online
## Quick Test Commands
```bash
# Test ping
ping -c 3 192.168.11.10
# Test port
timeout 5 bash -c "echo > /dev/tcp/192.168.11.10/8006" && echo "Port open" || echo "Port closed"
# Test SSH (if available)
ssh -o ConnectTimeout=5 root@192.168.11.10 "pvesh get /nodes" && echo "SSH works" || echo "SSH failed"
# Check current network
ip addr show | grep "inet "
```