ESXi Guides Index

Comprehensive documentation for ESXi installation, configuration, management, and upgrades in a homelab environment.

🚀 Quick Start

New Installation

  1. Installation Guide - Fresh ESXi installation and initial setup
  2. SSH Key Setup - Configure SSH key authentication
  3. Hostname Management - Set up proper hostnames and domains

Existing Infrastructure

  1. ESXi 8.0U3 Upgrade Guide - Latest: Automated upgrade documentation
  2. Backup Strategy - Configuration and data backup procedures
  3. VIB Backup Guide - Package inventory management

📋 Documentation Index

Installation and Setup

| Guide | Description | Status | |——-|————-|——–| | Installation Guide | Fresh ESXi installation procedures | ✅ Current | | ESXi Install | Basic installation documentation | ✅ Current | | SSH Key Setup | SSH authentication configuration | ✅ Current | | Hostname Management | Hostname and domain setup | ✅ Current |

Upgrades and Updates

| Guide | Description | Status | |——-|————-|——–| | ESXi 8.0U3 Upgrade Guide | Automated upgrade documentation | ✅ Latest | | Upgrade without vCenter | Manual upgrade procedures | ✅ Current | | Upgrade with vCenter8 | vCenter-managed upgrades | ✅ Current |

Management and Maintenance

| Guide | Description | Status | |——-|————-|——–| | Backup Strategy | Configuration backup procedures | ✅ Current | | VIB Backup Guide | Package inventory management | ✅ Current | | Datastore Best Practices | Storage configuration guidelines | ✅ Current |

🏗️ Infrastructure Overview

Current Homelab Setup

  • Platform: Mixed Intel/Apple hardware (3x Intel NUCs + 1x Mac Pro)
  • ESXi Versions: Mixed environment (8.0.3 + 7.0.3)
  • Domain: markalston.net
  • Management: SSH key-based automation

Hardware Details

| Host | IP | FQDN | Hardware | ESXi Version | Status | |——|—-|—– |———-|————–|——–| | esxi-nuc-01 | 192.168.10.8 | esxi-nuc-01.markalston.net | Intel NUC6i7KYK | ✅ ESXi 8.0.3 | Active | | esxi-nuc-02 | 192.168.10.9 | esxi-nuc-02.markalston.net | Intel NUC6i7KYK | ✅ ESXi 8.0.3 | Active | | esxi-nuc-03 | 192.168.10.10 | esxi-nuc-03.markalston.net | Intel NUC6i7KYK | ✅ ESXi 8.0.3 | Active | | esxi-macpro | TBD | esxi-macpro.markalston.net | Mac Pro Late 2013 | ✅ ESXi 7.0.3 | vCenter Host |

Mixed Environment Architecture 

┌─────────────────────────────────────────┐
│            Mixed ESXi Environment       │
├─────────────────────────────────────────┤
│                                         │
│  Mac Pro Late 2013 (ESXi 7.0.3)        │
│  ┌─────────────────────────────┐         │
│  │     VCSA 8.0.2              │         │
│  │  (vCenter Server)           │         │
│  └─────────────────────────────┘         │
│              │                          │
│              │ Manages                  │
│    ┌─────────┴────────┐                 │
│    │                  │                 │
│ ┌──▼───┐    ┌─────────▼──┐    ┌─────────┐│
│ │NUC-01│    │   NUC-02   │    │ NUC-03  ││
│ │8.0.3 │    │   8.0.3    │    │  8.0.3  ││
│ └──────┘    └────────────┘    └─────────┘│
└─────────────────────────────────────────┘

🔧 Automation Scripts

Available Scripts

Located in /scripts/ directory:

Script Purpose Compatibility Documentation
upgrade-esxi-remote.sh Automated ESXi upgrades ESXi 8.0 only ESXi 8.0U3 Guide
deploy-esxi-ssh-keys.sh SSH key deployment Mixed environment SSH Key Setup
backup-esxi-config.sh Configuration backups Mixed environment Backup Strategy
backup-esxi-vibs.sh VIB inventory backups Mixed environment VIB Backup Guide
update-esxi-domains.sh Domain configuration Mixed environment Hostname Management
update-esxi-hostnames.sh Hostname management Mixed environment Hostname Management

Usage Examples 

# Automated ESXi upgrade
./scripts/upgrade-esxi-remote.sh

# Deploy SSH keys to all hosts
./scripts/deploy-esxi-ssh-keys.sh

# Backup all host configurations
./scripts/backup-esxi-config.sh

# Update domain configuration
./scripts/update-esxi-domains.sh markalston.net

📊 Upgrade History

ESXi 8.0U3 Upgrade (July 20, 2025)

  • Status: ✅ Successful (3/3 hosts)
  • Method: Automated offline bundle deployment
  • Documentation: ESXi 8.0U3 Upgrade Guide
  • Key Achievement: First fully automated homelab upgrade

Previous Versions

  • ESXi 7.0.3 build-21424296 (Previous)
  • Upgrade Path: 7.0.3 → 8.0.3 (Direct upgrade)

⚠️ Important Notes

Hardware Compatibility Matrix

Intel NUC6i7KYK (Skylake)

  • ESXi 8.0.x: ✅ Fully supported with deprecation warnings
  • Future Releases: ❌ Skylake CPUs will NOT be supported beyond vSphere 8.0.x
  • Required Flag: --no-hardware-warning for upgrades
  • Planning: Hardware refresh needed for post-8.0 releases

Mac Pro Late 2013 (Ivy Bridge)

  • ESXi 7.0.x: ✅ Fully supported until April 2027
  • ESXi 8.0.x: ❌ CPU architecture incompatible
  • Strategy: Maintain on ESXi 7.0 for vCenter hosting
  • VCSA 8.0: ✅ Can run VCSA 8.0 on ESXi 7.0.3

Critical Configuration

  • Domain: markalston.net (professional DNS setup)
  • SSH Keys: Required for automation scripts
  • Backup Strategy: Automated configuration and VIB backups
  • Network: Dual NIC setup with USB adapters (NUCs)
  • Mixed Environment: vCenter 8.0 manages both ESXi 7.0 and 8.0 hosts

🔍 Quick Reference

Common Commands 

# Check ESXi version
vmware -v

# Get hostname configuration
esxcli system hostname get

# List datastores
esxcli storage filesystem list

# Check maintenance mode
esxcli system maintenanceMode get

# Backup configuration
vim-cmd hostsvc/firmware/backup_config

Key File Locations

  • SSH Config: ~/.ssh/config
  • SSH Keys: ~/.ssh/esxi_homelab
  • Backups: /Users/markalston/backup/homelab/esxi-config-backups/
  • Scripts: /scripts/
  • Documentation: /docs/guides/esxi/

🆘 Troubleshooting

Quick Diagnosis

  1. Can’t SSH: Check SSH key deployment and service status
  2. Upgrade Fails: Verify hardware compatibility and required flags
  3. Network Issues: Check dual NIC configuration and USB adapters
  4. Storage Problems: Verify datastore mounting and paths

Support Resources

📈 Future Planning

Short Term

  • Deploy VCSA 8.0.2 on Mac Pro Late 2013
  • Monitor ESXi 8.0.x stability and performance on Intel NUCs
  • Implement advanced backup automation for mixed environment
  • Set up monitoring and alerting across both ESXi versions

Long Term

  • Plan hardware refresh for Intel NUCs (post-vSphere 8.0 compatibility)
  • Consider Intel NUC12/13 Pro or MINISFORUM MS-A2 options
  • Mac Pro replacement planning (before ESXi 7.0 EOL in 2027)
  • Evaluate container and Kubernetes integration on ESXi 8.0 hosts

Last Updated: July 20, 2025
ESXi Version: 8.0.3 build-24022510
Infrastructure Status: ✅ Fully Operational

This project is for educational and home lab purposes.