loc_az_hci/docs/temporary/QUICK_START.md

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

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:

# 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:

# 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

# 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.