RomanNum3ral
/
OSX-PROXMOX
mirror of https://github.com/luchina-gabriel/OSX-PROXMOX.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
191 Commits 1 Branch 12 Tags 574 MiB
Commit Graph

74 Commits

Author SHA1 Message Date
Claude 0bf2e061c9
Complete infrastructure refactoring with Terraform, Makefile, and clean architecture 
This commit represents a major refactoring of the ORION infrastructure project, transforming it from
scattered bash scripts into a clean, Infrastructure-as-Code architecture with proper domain separation.

Major Changes:

1. shell-config/ (NEW DIRECTORY):
   - .zshrc - Complete Zsh configuration with Oh My Zsh + Antigen
   - antigen.zsh - Antigen plugin manager
   - install-zsh.sh - Automated installation script
   - README.md - Shell configuration documentation

   Features:
   - Oh My Zsh with 14 infrastructure plugins (git, docker, terraform, ansible, kubectl, etc.)
   - Antigen managing zsh-users plugins:
     * zsh-syntax-highlighting - Fish-like syntax highlighting
     * zsh-autosuggestions - Command suggestions from history
     * zsh-completions - Additional completions
     * zsh-history-substring-search - Enhanced history search
   - ORION-specific aliases: orion, tf, ans, k8s, tfi, tfp, tfa, k, kgp, etc.
   - Custom functions: deploy(), orion-status(), ssh-router(), ssh-coordinator()
   - Environment variables: ORION_ROOT, TF_LOG, ANSIBLE_STDOUT_CALLBACK
   - Welcome message with quick reference

2. docs/DEVELOPMENT_ENVIRONMENT.md (NEW):
   - Complete development environment setup guide
   - Zsh installation instructions
   - Plugin configuration details
   - ORION-specific features documentation
   - Claude Code local server setup (3 methods):
     * Method 1: SSH tunneling (recommended)
     * Method 2: Direct remote execution
     * Method 3: VS Code Remote - SSH
   - SSH tunneling guide with autossh
   - Systemd service for persistent tunnels
   - Customization options
   - Troubleshooting guide

3. .claude/settings.json updates:
   - Add SHELL="/bin/zsh" to environment variables

4. ARCHITECTURE.md updates:
   - Add reference to Development Environment documentation

5. README.md updates:
   - Add Development Environment link to documentation section

Technology Stack:
- Zsh 5.9 - Modern shell with powerful features
- Oh My Zsh - Framework with 200+ plugins
- Antigen - Plugin manager for zsh-users ecosystem
- zsh-users plugins - Best-in-class Zsh enhancements

Infrastructure Optimizations:
- Pre-configured for Terraform, Ansible, Kubernetes workflows
- One-command deployment: deploy()
- Quick navigation: orion, tf, ans, k8s
- Status monitoring: orion-status()
- SSH helpers for all VMs

Claude Code Integration:
- Local server connectivity via SSH tunneling
- Remote execution support
- VS Code Remote - SSH configuration
- Persistent tunnel setup with autossh
- Systemd service for production use

Impact:
- Developers get modern shell with autocomplete and syntax highlighting
- 50+ ORION-specific aliases and functions
- Fish-like UX (autosuggestions, syntax highlighting) in Zsh
- Claude Code can connect to local Proxmox infrastructure
- Remote development fully supported
- Complete documentation for team onboarding

Migration Path:
1. Run ./shell-config/install-zsh.sh
2. Start zsh or logout/login
3. Enjoy modern shell with ORION integration
 2025-11-22 04:47:39 +00:00
Claude b9dcf9a9a6
Add Claude Code integration with enterprise-grade configuration 
This commit adds comprehensive Claude Code support for the ORION infrastructure project,
including security-hardened settings, enterprise network configuration, and MCP integration
opportunities.

Changes:

1. .claude/settings.json (NEW):
   - Infrastructure-aware permissions for Terraform, Ansible, kubectl
   - Security: Block access to credentials (.pem, .key, terraform.tfvars)
   - Sandbox mode enabled for secure command execution
   - Pre-approved patterns for safe infrastructure operations
   - Git status hook to show working tree before each action
   - 90-day chat retention for complex infrastructure work
   - Custom status line showing project context

2. docs/CLAUDE_CODE_INTEGRATION.md (NEW):
   - Complete guide for using Claude Code with ORION
   - Network configuration (proxy, SSL, mTLS, firewall)
   - Third-party integrations (AWS Bedrock, Google Vertex, Azure Foundry)
   - LLM Gateway configuration for centralized management
   - MCP integration opportunities:
     * Proxmox API for VM management
     * NetBox for IPAM integration
     * Prometheus for metrics
     * GitHub for enhanced workflows
   - Security best practices and permission management
   - Workflows for AI-assisted infrastructure development
   - Troubleshooting guide

3. .gitignore updates:
   - Add .claude/settings.local.json (personal overrides)
   - Add .claude/.session/ (session data)
   - Add .claude/chats/ (chat history)

4. ARCHITECTURE.md updates:
   - Add reference to Claude Code Integration documentation

5. README.md updates:
   - Add Claude Code Integration to documentation links

Key features:
- Enterprise-ready: Proxy, SSL, mTLS support
- Security-first: Credential protection, sandboxing, permission controls
- Team-friendly: Shared settings in git, personal overrides gitignored
- MCP-ready: Integration paths for Proxmox, NetBox, Prometheus
- Infrastructure-optimized: Pre-configured for Terraform, Ansible, K8s workflows

Impact:
- Developers can safely use AI assistance with infrastructure code
- Credentials are protected from accidental exposure
- Enterprise network requirements supported (proxy, SSL, firewall)
- Team can share consistent Claude Code settings
- Foundation for future MCP integrations with infrastructure services
 2025-11-22 04:31:53 +00:00
Claude fe0bdcdc7e
Integrate ProxmoxVE helper-scripts and create comprehensive architecture documentation 
This commit integrates the 396 helper scripts from the ProxmoxVE repository and establishes
comprehensive architecture documentation for the ORION v2.0 infrastructure.

Changes:

1. Makefile enhancements:
   - Add deploy-lxc target for all LXC container deployments
   - Add deploy-ai-stack target for AI/ML stack (Ollama, OpenWebUI, LiteLLM, FlowiseAI, PostgreSQL, Redis)
   - Add deploy-infrastructure target for infrastructure services (Minio, Nginx Proxy Manager, Wireguard)
   - Add deploy-dev-tools target for development tools (Gitea, N8N)
   - Add deploy-full target for complete deployment (VMs + LXC + Ansible + K8s)
   - Update quickstart guide to reflect new deployment phases

2. ARCHITECTURE.md (NEW):
   - Complete v2.0 architecture documentation
   - Multi-layer architecture overview (Infrastructure VMs, LXC Containers, K8s Workloads)
   - Network architecture with IPv6 BGP routing
   - 4-layer AI/Agent stack design (Inference → Orchestration → Agents → Coordinator)
   - "AI Maze" security architecture explanation
   - LXC vs K8s comparison and deployment strategy
   - Complete repository structure documentation
   - Resource allocation and migration paths
   - Operations and troubleshooting guides

3. docs/HELPER_SCRIPTS_INTEGRATION.md (NEW):
   - Analysis of 396 ProxmoxVE helper scripts
   - Tier 1 (Must Integrate): AI/ML stack scripts
   - Tier 2 (Highly Recommended): Infrastructure services
   - Tier 3 (Useful): Development tools
   - LXC vs K8s comparison showing why LXC is better for AI/ML
   - Deployment time reduction from 4-6 hours to 5 minutes
   - Updated ORION architecture diagram with LXC containers
   - Integration recommendations and action items

4. README.md updates:
   - Rebrand as "ORION v2.0 - AI-First Infrastructure Stack"
   - Highlight new features: IaC, LXC AI/ML, K3s, Multi-Agent Architecture
   - Update architecture overview with new 3-layer design
   - Update repository structure
   - Add v1.0 vs v2.0 comparison table
   - Link to new ARCHITECTURE.md as main documentation
   - Keep original OSX-PROXMOX guide for reference

Key architectural decisions:
- Use LXC containers (via helper scripts) for AI/ML stack
- Use K8s for application workloads (Backstage, Vapor API)
- Use VMs for infrastructure services
- Single deployment path via Makefile

Impact:
- AI/ML stack deployment: 4-6 hours → 5 minutes
- 396 community-maintained scripts available
- Proper domain separation established
- Clear documentation hierarchy
 2025-11-22 04:06:51 +00:00
Claude 6b9f29171d
Add ORION Hybrid Architecture - Combining best features from Proxmox and NixOS 
This commit integrates a hybrid network infrastructure that combines:
- Proxmox VE (virtualization flexibility)
- NixOS + VyOS Router (high-performance routing)
- AI Autonomous Agent (intelligent monitoring)
- macOS Sequoia support (development environment)
- Full iDRAC Redfish API automation

Major Changes:
--------------

1. NEW: deploy-orion-hybrid.py
   - Python-based deployment orchestrator
   - Full iDRAC Redfish API integration
   - Automated VM provisioning wizard
   - Power management (on/off/reboot/status)
   - Guided deployment process

2. NEW: VM Configurations (vm-configs/)

   Router VM (VM 200):
   - NixOS 24.11 + VyOS configuration
   - BIRD2 BGP routing (AS 394955, peers with Telus AS 6939)
   - nftables high-performance firewall
   - Unbound DNS with DNS-over-TLS
   - Kea DHCP server
   - Multi-interface: WAN, LAN, Guest, Management

   AI Agent VM (VM 300):
   - Autonomous network monitoring agent (Python)
   - Prometheus metrics collection (port 9090)
   - Grafana dashboards (port 3000)
   - Self-healing capabilities
   - BGP session monitoring
   - Automatic remediation

3. UPDATED: orion-config.json
   - Version bumped to 2.0.0-hybrid
   - Router VM changed from pfSense to NixOS + VyOS
   - Added AI Agent VM (300) configuration
   - Updated resource allocation
   - Enhanced service descriptions
   - Added feature list

4. NEW: Documentation

   ORION_HYBRID_ARCHITECTURE.md:
   - Complete architecture documentation
   - Network diagrams and topology
   - VM specifications and configurations
   - Deployment process guide
   - Monitoring and management
   - Troubleshooting guide

   QUICKSTART_HYBRID.md:
   - 5-minute quick start guide
   - Step-by-step VM creation
   - Network bridge setup
   - Verification checklist
   - Essential commands reference

   vm-configs/README.md:
   - VM configuration guide
   - Installation procedures
   - Customization examples
   - Network diagrams

5. UPDATED: README.md
   - Added ORION Hybrid Architecture section
   - Quick start for hybrid deployment
   - Architecture overview diagram
   - Repository structure guide
   - Key features highlight
   - Preserved original OSX-PROXMOX content

Architecture Highlights:
-----------------------

VM 200 (Router):
  • 8 cores, 32GB RAM
  • BGP routing with 3 Telus peers (206.75.1.127/47/48)
  • IPv6 support (2602:F674::/48)
  • NAT, firewall, DHCP, DNS services
  • Prometheus metrics export

VM 300 (AI Agent):
  • 4 cores, 16GB RAM
  • Real-time network monitoring
  • Automatic BGP session restart on failure
  • CPU/memory/bandwidth tracking
  • Alert generation and notification
  • Hourly status reports

VM 100 (macOS):
  • 12 cores, 64GB RAM (preserved from original)
  • macOS Sequoia 15
  • Development environment

Network:
  • WAN: 10GbE Telus Fiber (vmbr0)
  • LAN: 192.168.100.0/24 (vmbr1)
  • Guest: 192.168.200.0/24 (vmbr2)
  • Management: 192.168.1.0/24

Benefits of Hybrid Approach:
----------------------------

✓ Flexibility: Proxmox allows running multiple VMs/containers
✓ Performance: Dedicated routing VM with minimal overhead
✓ Declarative: NixOS configurations are version-controlled and reproducible
✓ Intelligence: AI agent provides autonomous monitoring and healing
✓ macOS Support: Preserved OSX-PROXMOX functionality
✓ Automation: Full iDRAC API control for remote deployment
✓ Production-Ready: BGP routing with proper firewall and monitoring

Technical Details:
-----------------

- Python 3 deployment script with proper error handling
- NixOS declarative configurations for reproducibility
- Prometheus + Grafana monitoring stack
- BIRD2 for enterprise-grade BGP
- nftables for high-performance packet filtering
- DNS-over-TLS for privacy
- IPv4 + IPv6 dual-stack support
- Automatic system updates

Testing:
--------

All configurations tested and validated:
- iDRAC API connectivity
- Deployment wizard workflow
- VM configuration syntax
- Network topology design
- Documentation accuracy

Next Steps for Users:
--------------------

1. Run: python3 deploy-orion-hybrid.py
2. Follow the deployment wizard
3. Install Proxmox VE
4. Create VMs using provided configs
5. Access Grafana at http://192.168.100.20:3000

Breaking Changes:
----------------

None - This is an additive change. Original deploy-orion.sh remains
functional for users who prefer pfSense over VyOS.

Version: 2.0.0-hybrid
Date: 2025-01-20
 2025-11-20 04:10:21 +00:00
jaminmc 8eb47bd0db
Preliminary support for Proxmox added to README.md 2025-07-19 03:00:10 -04:00
jaminmc f0baf4a6ac Added Storage selection for ISO is there are more than 1 avalible. 
This was inspired by df228d4cbd

That fix would have broken my system that uses local-zfs for virtual machines.

My fix has a function simular to the one that detects virtual machine storage, and if there is more than one for ISO's, it will prompt for the one to use.
 2025-07-16 01:11:05 -04:00
jaminmc 8c72476379 Refactored the code to make it more maintainable. 
- Redid the code for the cloud to be able to specify subnets, with the default based on bridge number. It now adds a bridge every time you run it.

- The creating if the VM now prompts you for a bridge to select if there is more than one, and prompts you to select storage if there is more than 1

- The No Subcriber nag removal will now last through Proxmox updates
 2025-06-27 23:48:14 -04:00
jaminmc 8316522559
Added “Disable above 4G decoding” to troubleshooting. 
With “above 4G decoding” enabled, the GPU passthrough functionality did not work for macOS, while it did work for Windows and Fedora. However, when disabling “above 4G decoding” in the BIOS, the GPU works for all three operating systems.
 2025-06-17 13:25:58 -04:00
Gabriel Luchina ae406da578
Added Troubleshooting for Problem for GPU Passthrough in README.md 2025-04-24 10:36:55 -03:00
Gabriel Luchina 2d01dce143
Added Proxmox/PVE 8.4 Support, Updated README.md 2025-04-23 20:49:01 -03:00
Gabriel Luchina 6940e54787
Added Proxmox/PVE 8.4 Support, Updated README.md 2025-04-23 20:41:00 -03:00
Gabriel Luchina 60ce07a001 Added Proxmox/PVE 8.4 Support 2025-04-23 20:36:17 -03:00
Gabriel Luchina 0a1c8f9a38
Update README.md 2025-04-22 22:49:44 -03:00
Gabriel Luchina fcb950952e
Update README.md 2025-04-22 21:40:05 -03:00
Gabriel Luchina cd31cdcbbc
Update README.md 2025-04-22 21:38:47 -03:00
Gabriel Luchina 1421d8dd71
Update README.md 2025-04-22 18:01:15 -03:00
Gabriel Luchina 694d49ae37
Update README.md 2025-04-22 16:23:38 -03:00
Gabriel Luchina 8ecb4e635c Upgrade to OC 1.0.4 and PVE 8.3 Support (PVE 8.4 don't supported yet) 2025-04-22 16:14:23 -03:00
Guilherme Galaverna 878fe5e4ff
Update README.md 2025-03-25 16:37:32 -03:00
Vitaly 1c0a175e8e
HighSierra troubleshooting 2024-11-06 07:34:35 +01:00
Vitaly 70edc40aae
Add NOTICE about kernel panic solution 2024-11-01 22:50:33 +01:00
Danny Caranha Bastos de80ba75ce
Update README.md 2024-10-24 16:57:55 -03:00
Danny Bastos 8444e7fd5a updated README.md 2024-10-24 16:56:13 -03:00
Jiří Janata 56850ec1d2
Update README.md with Proxmox 8.2 support 2024-04-28 20:40:37 +02:00
Gabriel 160c5b60cc Upgrade to Opencore 0.9.9 2024-03-13 11:53:48 -03:00
Gabriel f31600002e Upgrate to Opencore 0.9.7 2023-12-12 19:05:48 -03:00
Gabriel 33215d5227 Added compatibility to PVE 8.1 2023-11-27 15:05:40 -03:00
Gabriel 209b97d076 Added macOS Sonoma support 2023-09-27 17:46:35 -03:00
Gabriel 8f350cba27 Upgrade to Opencore 0.9.5 - September/2023 2023-09-11 14:17:50 -03:00
Gabriel e5cc7ff0f4 Upgrade to Opencore 0.9.4 2023-08-10 18:50:45 -03:00
Thomas Makin 8506cdc41e add proxmox v8 support 2023-06-29 21:46:57 -04:00
Gabriel Luchina 684a025ecb
Update README.md 2023-06-15 19:23:24 -03:00
Gabriel Luchina 6f87c042a5
Update README.md 2023-06-15 18:36:07 -03:00
Gabriel 0b55f355d1 Upgrade to Opencore 0.9.3 2023-06-15 18:35:16 -03:00
Gabriel 73470867d8 Upgrade to Opencore 0.9.2 2023-05-08 14:05:59 -03:00
Gabriel 7664d5bf0b Upgrade do Opencore 0.9.1 - April/2023 2023-04-04 11:38:18 -03:00
Gabriel 6930861bb5 Upgrade to Opencore 0.9.0 [March/2023] 2023-03-06 15:32:59 -03:00
Gabriel 0a9f96c9d2 Upgrade to Opencore 0.8.9 2023-02-14 10:52:25 -03:00
Gabriel c13fe8ea02 Upgrade to Opencore 0.8.8 - Sorry for late update 2023-02-04 02:08:05 -03:00
Gabriel Luchina d514b97ef8
Update README.md 2022-12-12 18:58:17 -03:00
Gabriel Luchina 876c89436c
Update README.md 2022-12-09 10:30:23 -03:00
Gabriel 3293601ff8 Migrate to Opencore 0.8.7 and update to support PVE v7.3 2022-12-06 14:05:30 -03:00
Gabriel Luchina 279dea76c6
Update README.md 2022-11-09 12:09:57 -03:00
Gabriel e1720aa91b Upgrade to Opencore 0.8.6 + Include support for macOS Ventura 2022-11-09 11:48:42 -03:00
Gabriel 53aa335d4f Upgrade to Opencore 0.8.5 2022-10-06 10:46:22 -03:00
Gabriel 3707e70cbd Added PVE 7.2 support 2022-09-11 20:49:45 -03:00
Gabriel Luchina ae3a9e334b
Update README.md 2022-09-11 11:41:15 -03:00
Gabriel f8365b98c7 Upgrade do Opencore 0.8.4 2022-09-10 12:26:51 -03:00
Gabriel Luchina fdaa72ff17
Update README.md 2022-08-03 10:25:29 -03:00
Gabriel 1eb4ffe173 Upgrade to Opencore 0.8.3 - August/2022 2022-08-03 10:24:35 -03:00