# Access Paths Visual Map

```
┌─────────────────────────────────────────────────────────────────┐
│                    YOUR WORKSTATION                              │
│                                                                   │
│  SSH Key: ~/.ssh/id_ed25519_proxmox                             │
│  Browser: Access to Web UIs                                     │
│  Scripts: Automation tools                                       │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │
        ┌─────────────────────┼─────────────────────┐
        │                     │                     │
        ▼                     ▼                     ▼
┌──────────────┐      ┌──────────────┐      ┌──────────────┐
│  Proxmox     │      │  Proxmox     │      │  Virtual     │
│  ML110       │      │  R630        │      │  Machines    │
│              │      │              │      │              │
│ 192.168.1.206│      │ 192.168.1.49 │      │ 100-103      │
└──────────────┘      └──────────────┘      └──────────────┘
        │                     │                     │
        │                     │                     │
   ┌────┴────┐           ┌────┴────┐          ┌────┴────┐
   │         │           │         │          │         │
   ▼         ▼           ▼         ▼          ▼         ▼
┌─────┐  ┌─────┐     ┌─────┐  ┌─────┐    ┌─────┐  ┌─────┐
│Web │  │ SSH │     │Web │  │ SSH │    │Console│ │ SSH │
│UI  │  │     │     │UI  │  │     │    │      │ │     │
│✅  │  │ ✅  │     │✅  │  │ ❌  │    │ ✅   │ │ ❌  │
└─────┘  └─────┘     └─────┘  └─────┘    └─────┘  └─────┘
   │         │           │         │          │         │
   └────┬────┘           └────┬────┘         └────┬────┘
        │                     │                     │
        ▼                     ▼                     ▼
   ┌─────────┐          ┌─────────┐          ┌─────────┐
   │   API   │          │   API   │          │  QEMU   │
   │   ✅    │          │   ✅    │          │  Guest  │
   └─────────┘          └─────────┘          │  Agent  │
                                               │   ❌    │
                                               └─────────┘
```

## Access Path Status

### ✅ Working Paths

**Proxmox ML110 (192.168.1.206):**
- ✅ Web UI: https://192.168.1.206:8006
- ✅ SSH: `ssh -i ~/.ssh/id_ed25519_proxmox root@192.168.1.206`
- ✅ API: https://192.168.1.206:8006/api2/json

**Proxmox R630 (192.168.1.49):**
- ✅ Web UI: https://192.168.1.49:8006
- ✅ API: https://192.168.1.49:8006/api2/json

**Virtual Machines (100-103):**
- ✅ Console: Via Proxmox Web UI
- ✅ Network: All reachable (ping)
- ✅ Port 22: All open

### ❌ Not Working (With Fixes)

**SSH to VMs:**
- ❌ Authentication failing
- 🔧 Fix: Use Proxmox console to add SSH key

**SSH to R630:**
- ❌ Authentication failing
- 🔧 Fix: Enable SSH and add key

**QEMU Guest Agent:**
- ❌ Not running in VMs
- 🔧 Fix: Install via console

## Access Flow Diagram

```
Workstation
    │
    ├─→ Proxmox ML110 (✅ Web UI, ✅ SSH, ✅ API)
    │       │
    │       └─→ VM Console (✅ Available)
    │       └─→ QEMU Guest Agent (❌ Not installed)
    │
    ├─→ Proxmox R630 (✅ Web UI, ❌ SSH, ✅ API)
    │       │
    │       └─→ VM Console (✅ Available)
    │
    └─→ Virtual Machines (❌ SSH, ✅ Network, ✅ Console)
            │
            ├─→ VM 100: 192.168.1.60 (cloudflare-tunnel)
            ├─→ VM 101: 192.168.1.188 (k3s-master)
            ├─→ VM 102: 192.168.1.121 (git-server)
            └─→ VM 103: 192.168.1.82 (observability)
```

## Troubleshooting Decision Tree

```
Need to access VM?
    │
    ├─→ SSH working? → Use SSH
    │
    ├─→ SSH not working?
    │       │
    │       ├─→ Console available? → Use Console
    │       │
    │       ├─→ QEMU Guest Agent? → Use qm guest exec
    │       │
    │       └─→ Network reachable? → Use service APIs
    │
    └─→ Need Proxmox host access?
            │
            ├─→ SSH working? → Use SSH
            │
            ├─→ SSH not working?
            │       │
            │       ├─→ Web UI available? → Use Web UI
            │       │
            │       └─→ API working? → Use API
            │
            └─→ Physical access? → Use Console/KVM
```

## Priority Matrix

| Task | Priority 1 | Priority 2 | Priority 3 |
|------|-----------|------------|------------|
| VM Management | Web UI | SSH | API |
| Service Config | SSH | Console | QEMU Agent |
| Automation | API | SSH | Web UI |
| Troubleshooting | Console | SSH | QEMU Agent |

---

**Legend:**
- ✅ Working
- ❌ Not working
- 🔧 Needs fix
- ⏳ Pending