# Quick Start Guide

## Current Status

✅ **Ready to Deploy**
- Proxmox connections verified (both servers)
- Environment variables configured
- Setup scripts created
- Terraform configuration ready

## Immediate Next Steps

### 1. Create Service VMs

**Option A: Proxmox Web UI (Recommended)**
- Access: https://192.168.1.206:8006 or https://192.168.1.49:8006
- See `CREATE_VMS.md` for detailed instructions

**Option B: Terraform**
```bash
cd terraform/proxmox
terraform init
terraform plan
terraform apply
```

### 2. Install OS on VMs

For each VM:
1. Boot from Ubuntu 22.04 LTS ISO
2. Complete installation
3. Configure static IP addresses:
   - Cloudflare Tunnel: 192.168.1.60
   - K3s Master: 192.168.1.188
   - Git Server: 192.168.1.121
   - Observability: 192.168.1.82

### 3. Run Setup Scripts

**On Cloudflare Tunnel VM:**
```bash
# Copy script to VM
scp scripts/setup-cloudflare-tunnel.sh user@192.168.1.60:/tmp/

# SSH to VM and run
ssh user@192.168.1.60
sudo bash /tmp/setup-cloudflare-tunnel.sh
```

**On K3s VM:**
```bash
# Copy script to VM
scp scripts/setup-k3s.sh user@192.168.1.188:/tmp/

# SSH to VM and run
ssh user@192.168.1.188
sudo bash /tmp/setup-k3s.sh
```

## Service VM Specifications

| VM Name | VM ID | IP Address | CPU | RAM | Disk | Purpose |
|---------|-------|------------|-----|-----|------|---------|
| cloudflare-tunnel | 100 | 192.168.1.60 | 2 | 4GB | 40GB | Cloudflare Tunnel |
| k3s-master | 101 | 192.168.1.188 | 4 | 8GB | 80GB | Kubernetes |
| git-server | 102 | 192.168.1.121 | 4 | 8GB | 100GB | Git Server |
| observability | 103 | 192.168.1.82 | 4 | 8GB | 200GB | Monitoring |

## Connection Information

### Proxmox
- **ML110**: https://192.168.1.206:8006
- **R630**: https://192.168.1.49:8006
- **Username**: root@pam
- **Password**: (from `.env` file: `PVE_ROOT_PASS`)

### Cloudflare
- **Dashboard**: https://dash.cloudflare.com
- **Zero Trust**: https://one.dash.cloudflare.com
- **Tunnel Token**: (from `.env` file: `CLOUDFLARE_TUNNEL_TOKEN`)

## Testing Connections

```bash
# Test Proxmox
./scripts/utils/test-proxmox-connection.sh

# Test Cloudflare (if API key configured)
./scripts/utils/test-cloudflare-connection.sh
```

## Documentation

- **CREATE_VMS.md** - Detailed VM creation guide
- **DEPLOYMENT_WITHOUT_AZURE.md** - Complete deployment plan
- **docs/cloudflare-integration.md** - Cloudflare setup details
- **docs/deployment-guide.md** - General deployment guide

## Troubleshooting

### Proxmox Connection Issues
- Verify IP addresses in `.env` file
- Check network connectivity: `ping 192.168.1.206`
- Accept self-signed certificate in browser

### VM Creation Issues
- Ensure sufficient storage on Proxmox host
- Check VM ID availability (use `./scripts/proxmox/create-service-vms.sh`)
- Verify network bridge configuration

### Cloudflare Tunnel Issues
- Verify tunnel token in `.env`
- Check DNS records in Cloudflare Dashboard
- Review tunnel logs: `journalctl -u cloudflared -f`

## Next Steps After VM Creation

1. ✅ Create VMs (this step)
2. ⏭️ Install OS and configure networking
3. ⏭️ Run setup scripts
4. ⏭️ Configure Cloudflare Tunnel
5. ⏭️ Deploy Kubernetes services
6. ⏭️ Set up GitOps

See `DEPLOYMENT_WITHOUT_AZURE.md` for complete workflow.