# Quick Start Guide

Fastest path to get Cloudflare Tunnels running for your Proxmox hosts.

## Prerequisites

✅ Cloudflare account with Zero Trust enabled  
✅ Domain `d-bis.org` managed by Cloudflare  
✅ VMID 102 exists and is running  
✅ Network access from VMID 102 to Proxmox hosts  

## 5-Minute Setup

### 1. Verify Prerequisites (30 seconds)

```bash
cd scripts/cloudflare-tunnels
./scripts/verify-prerequisites.sh
```

### 2. Create Tunnels in Cloudflare (2 minutes)

1. Go to: https://one.dash.cloudflare.com
2. Zero Trust → Networks → Tunnels → Create tunnel
3. Create three tunnels:
   - `tunnel-ml110`
   - `tunnel-r630-01`
   - `tunnel-r630-02`
4. Copy tunnel tokens/IDs

### 3. Run Setup Script (1 minute)

```bash
./scripts/setup-multi-tunnel.sh
```

Enter tunnel IDs and credential file paths when prompted.

### 4. Create DNS Records (1 minute)

In Cloudflare Dashboard → DNS → Records:

| Name | Type | Target | Proxy |
|------|------|--------|-------|
| ml110-01 | CNAME | `<tunnel-id>.cfargotunnel.com` | 🟠 ON |
| r630-01 | CNAME | `<tunnel-id>.cfargotunnel.com` | 🟠 ON |
| r630-02 | CNAME | `<tunnel-id>.cfargotunnel.com` | 🟠 ON |

### 5. Start Services (30 seconds)

```bash
# From VMID 102
systemctl start cloudflared-ml110 cloudflared-r630-01 cloudflared-r630-02
systemctl enable cloudflared-*
```

### 6. Verify (30 seconds)

```bash
./scripts/check-tunnel-health.sh
```

## Test Access

```bash
# Test DNS
dig ml110-01.d-bis.org

# Test HTTPS
curl -I https://ml110-01.d-bis.org
```

Should see Cloudflare Access login page or redirect.

## Next Steps

1. **Configure Cloudflare Access** (see `docs/CLOUDFLARE_ACCESS_SETUP.md`)
2. **Start Monitoring** (see `docs/MONITORING_GUIDE.md`)
3. **Set Up Alerting** (edit `monitoring/alerting.conf`)

## Troubleshooting

If something doesn't work:

```bash
# Check service status
systemctl status cloudflared-*

# Check logs
journalctl -u cloudflared-* -f

# Run health check
./scripts/check-tunnel-health.sh
```

See [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) for detailed help.

## Full Deployment

For complete setup with all features:

```bash
./scripts/deploy-all.sh
```

Or follow [DEPLOYMENT_CHECKLIST.md](DEPLOYMENT_CHECKLIST.md) step by step.

---

**That's it!** Your Proxmox hosts are now accessible via Cloudflare Tunnel.

