# Troubleshooting Proxmox Connection

**Last Updated:** 2026-01-31  
**Document Version:** 1.0  
**Status:** Active Documentation

---

## 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 "
```