devmatrix-docs/README.md

255 lines
6.1 KiB
Markdown

# DevMatrix Setup - Complete Data Dump
**Generated:** 2026-02-16
**Setup By:** OpenClaw AI Assistant
**Owner:** Roberth (@ImpulsiveFPS)
---
## 📊 Executive Summary
This repository documents the complete DevMatrix environment setup - a comprehensive AI-powered development infrastructure built on Proxmox with TrueNAS storage, multiple VMs, and homelab services.
### What Was Built
- **3 Virtual Machines** on Proxmox
- **TrueNAS Integration** with NFS/SMB shares
- **Docker-based Homelab** with monitoring and automation
- **Gitea Integration** for code management
- **OpenClaw AI Environment** for development assistance
---
## 🏗️ Infrastructure Overview
### Proxmox Host
| Setting | Value |
|---------|-------|
| IP Address | 192.168.5.200 |
| Storage (HDD) | pve-main2 |
| Storage (NVMe) | pve-main (future) |
| Network Bridge | vmbr1 |
| Gateway | 192.168.5.10 |
### TrueNAS
| Setting | Value |
|---------|-------|
| IP Address | 192.168.5.195 |
| Dataset | NAS2/devmatrix |
| Shares | projects, backups, iso-archive, shared |
| Protocols | NFS (Linux), SMB (Windows) |
---
## 💻 Virtual Machines
### VM 300: OpenClaw DevMatrix (Ubuntu 24.04)
```
Name: OpenClaw-DevMatrix
IP: 192.168.5.210
RAM: 32 GB
CPU: 16 cores
OS Disk: 200 GB (HDD → NVMe later)
Data Disk: 200 GB (HDD permanent)
Purpose: Primary development environment
```
**Installed Software:**
- ✅ OpenClaw 2026.2.16
- ✅ Docker + Docker Compose
- ✅ Node.js 20
- ✅ Python 3.12 + pipx tools
- ✅ Flutter (mobile dev)
- ✅ .NET 8
- ✅ PostgreSQL & Redis
- ✅ VS Code Server (port 8080)
- ✅ Git, Rust, Go
**Docker Containers:**
| Service | Port | Purpose |
|---------|------|---------|
| Portainer | 9000 | Docker management |
| n8n | 5678 | Workflow automation |
| Uptime Kuma | 3001 | Service monitoring |
| Heimdall | 8081 | Dashboard |
| Vaultwarden | 8082 | Password manager |
**Mounted Storage:**
- `/mnt/truenas/projects` → TrueNAS projects
- `/mnt/truenas/backups` → TrueNAS backups
- `/mnt/truenas/shared` → TrueNAS shared
---
### VM 301: Windows-LTSC-Test (Windows 11 IoT Enterprise LTSC)
```
Name: Windows-LTSC-Test
IP: 192.168.5.211
RAM: 16 GB
CPU: 8 cores
Disk: 100 GB
Purpose: Windows testing and UI automation
```
**Configured:**
- ✅ OpenSSH Server
- ✅ Remote Desktop (RDP)
- ✅ User: testuser / DevMatrix2024!
- ✅ Chocolatey package manager
- ✅ Git, Python, Node.js, .NET, VS Code
- ✅ Playwright for UI testing
---
### VM 302: Android-Emulator (Ubuntu 22.04)
```
Name: Android-Emulator
IP: 192.168.5.212
RAM: 8 GB
CPU: 4 cores
Disk: 50 GB
Purpose: Mobile development and testing
```
**Status:** Ready for Android SDK installation
---
## 📦 Gitea Repositories Created
| Repository | URL | Purpose |
|------------|-----|---------|
| devmatrix-scripts | https://git.lemonlink.eu/impulsivefps/devmatrix-scripts | All setup scripts |
| EU-Utility | https://git.lemonlink.eu/impulsivefps/EU-Utility | Framework project |
| EU-Utility-Plugins-Repo | https://git.lemonlink.eu/impulsivefps/EU-Utility-Plugins-Repo | Plugin repository |
| Lemontropia-Suite | https://git.lemonlink.eu/impulsivefps/Lemontropia-Suite | Analytics suite |
| EU-Icon-Extractor | https://git.lemonlink.eu/impulsivefps/EU-Icon-Extractor | Icon extraction tool |
| LifeFlow | https://git.lemonlink.eu/impulsivefps/LifeFlow | Life management app |
**Gitea User:** `devmatrix`
**Email:** spiritmotivational69@gmail.com
---
## 🔧 Scripts Created
All scripts available at: https://git.lemonlink.eu/impulsivefps/devmatrix-scripts
| Script | Purpose |
|--------|---------|
| `setup_devmatrix_proxmox_custom.sh` | Create VMs on Proxmox |
| `setup_openclaw_dev.sh` | Setup Ubuntu dev environment |
| `setup_windows_vm.ps1` | Configure Windows VM |
| `setup_truenas.sh` | Mount TrueNAS shares |
| `setup_truenas_shares.sh` | Create TrueNAS shares |
| `configure_api_keys.sh` | Configure AI provider keys |
| `migrate_to_nvme.sh` | Migrate VMs to NVMe (future) |
---
## 🌐 Network Configuration
### IP Addresses
```
192.168.5.10 - Gateway
192.168.5.195 - TrueNAS
192.168.5.200 - Proxmox
192.168.5.210 - VM 300 (Ubuntu)
192.168.5.211 - VM 301 (Windows)
192.168.5.212 - VM 302 (Android)
```
### Service Ports (VM 300)
```
8080 - VS Code Server
9000 - Portainer
5678 - n8n
3001 - Uptime Kuma
8081 - Heimdall
8082 - Vaultwarden
```
---
## 🔐 Security Notes
### SSH Keys
- **Location:** `~/.ssh/devmatrix_id_rsa` (Proxmox)
- **Public:** `~/.ssh/devmatrix_id_rsa.pub`
- **Used for:** VM 300 SSH access
### API Keys (VM 300)
- **Kimi:** Configured in `~/.openclaw/agent/auth-profiles/`
- **Antigravity:** Optional OAuth (not configured)
- **Gemini CLI:** Optional OAuth (not configured)
### Credentials
- **VM 300:** devmatrix / [password set during install]
- **VM 301:** testuser / DevMatrix2024!
- **VM 302:** To be configured
---
## 📋 Next Steps / TODO
### Immediate
- [ ] Complete Windows VM setup (script in progress)
- [ ] Install Android SDK on VM 302
- [ ] Configure API keys in OpenClaw
- [ ] Test VM-to-VM communication
### Short Term
- [ ] Install NVMe drive in Proxmox
- [ ] Migrate VM disks to NVMe
- [ ] Set up automated backups to TrueNAS
- [ ] Configure Vaultwarden with credentials
### Long Term
- [ ] Set up CI/CD pipelines
- [ ] Configure monitoring alerts
- [ ] Document workflows
- [ ] Create project templates
---
## 🚀 Quick Start Commands
### From Proxmox
```bash
# SSH to VM 300
ssh -i ~/.ssh/devmatrix_id_rsa devmatrix@192.168.5.210
# Check VM status
qm status 300
qm status 301
qm status 302
```
### From VM 300
```bash
# Access services
curl http://localhost:9000 # Portainer
curl http://localhost:5678 # n8n
curl http://localhost:8081 # Heimdall
# Test Windows VM
ssh testuser@192.168.5.211
# Check TrueNAS mounts
df -h | grep truenas
```
---
## 📞 Support
**Documentation:** https://docs.openclaw.ai
**Gitea:** https://git.lemonlink.eu
**Proxmox:** https://192.168.5.200:8006
**TrueNAS:** http://192.168.5.195
---
*Generated by OpenClaw AI Assistant for DevMatrix Project*
*Version: 2026.02.16*
*Status: Active Development*