packertron-vms

Automated VM deployment with Packer, Vagrant, Ansible across hypervisors

Warning

🚧 Project instructions and commands under review 🚧
The setup and deployment instructions in this README file are currently being tested and refined. Expect updates and improvements as I validate each step.

packertron-vms is a collection of templates for automated VM deployment, designed for home lab environments and testing setups. Using Packer and Vagrant, it simplifies the creation, provisioning, and management of virtual machines. The templates currently support VMware Workstation (future plans include Ansible automation and expanding hypervisor support like VirtualBox, Proxmox, etc).

---

📖 Table of Contents

• packertron-vms
  • 📖 Table of Contents
  • 🚀 Features
  • 🛠 Requirements
    • System Requirements
    • Software Dependencies
  • 🔧 Installation
    • 1️⃣ Install Chocolatey (Windows Users Only)
    • 2️⃣ Install Dependencies
    • 3️⃣ Install Vagrant VMware Plugin
    • 4️⃣ Clone packertron-vms Repository
  • 📁 Directory Structure
  • 🚀 Build & Deploy VMs
    • 1️⃣ Open Visual Studio Code
    • 2️⃣ Packer: Initialize & Build Windows Server 2025
    • 3️⃣ Deploy VM with Vagrant
    • 4️⃣ Manage VM Lifecycle
  • 🛠 Troubleshooting
  • 📜 License
  • 🤝 Contributing
  • 🌍 Future Roadmap

---

🚀 Features

• Automated VM builds using Packer
• Provisioning with Vagrant
• Support for multiple OS images (Windows, Ubuntu, Kali Linux, etc)
• Customizable HCL templates and scripts
• Hypervisor-agnostic VM automation

---

🛠 Requirements

Ensure you have the following installed before proceeding:

System Requirements

• Windows 10/11 or Linux
• VMware Workstation Pro (or Proxmox in future support)

Software Dependencies

• Chocolatey (Windows package manager)
• VMware Workstation
• HashiCorp Packer
• HashiCorp Vagrant
• Vagrant VMware Utility
• Vagrant VMware Plugin
• Visual Studio Code

---

🔧 Installation

1️⃣ Install Chocolatey (Windows Users Only)

Open PowerShell as Administrator and run:

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

Verify installation:

choco -?

2️⃣ Install Dependencies

choco install vmwareworkstation packer vagrant jq vscode -y

3️⃣ Install Vagrant VMware Plugin

choco install vagrant-vmware-utility -y
vagrant plugin install vagrant-vmware-desktop

4️⃣ Clone packertron-vms Repository

git clone https://github.com/syselement/packertron-vms.git
cd packertron-vms

---

📁 Directory Structure

packertron-vms/
├── Win2025/
│   ├── config/          # Configuration files (autounattend.xml, unattend.xml)
│   ├── scripts/         # Automation scripts (Powershell, Batch)
│   ├── variables.pkrvars.hcl  # Packer variables
│   ├── win2025.pkr.hcl  # Packer HCL template
│   ├── vagrantfile      # Vagrant configuration
│   ├── output/          # VM build output
└── .gitignore           # Ignore unnecessary files (ISO, temp builds)

---

🚀 Build & Deploy VMs

1️⃣ Open Visual Studio Code

cd packertron-vms
code .

2️⃣ Packer: Initialize & Build Windows Server 2025

cd Win2025
packer init .
packer validate --var-file="winserver2025.pkrvars.hcl" win2025.pkr.hcl
packer build --var-file="winserver2025.pkrvars.hcl" win2025.pkr.hcl

3️⃣ Deploy VM with Vagrant

cd Win2025
vagrant up

4️⃣ Manage VM Lifecycle

# Shut down VM
vagrant halt

# Restart VM
vagrant up

# Destroy VM
vagrant destroy -f

---

🛠 Troubleshooting

• VMware Workstation Not Detected? Ensure it is installed and running.

• ISO Checksum Mismatch?

  Run:

  Get-FileHash C:\ISO\windows\your_iso.iso

• Vagrant Plugin Issues?

  Reinstall:

  vagrant plugin repair

---

📜 License

Released under MIT by @syselement.

🤝 Contributing

Pull requests and improvements are welcome! Ensure your code follows the repo’s standards.

🌍 Future Roadmap

• ✅ Proxmox support
• ✅ Ubuntu & Kali Linux Packer builds
• ✅ Integration with Ansible for advanced provisioning

---

🚀 Happy Virtualizing with packertron-vms!