/homebridge-vm-image

A minimal live-boot ISO image that runs Homebridge automatically.

Primary LanguageShellApache License 2.0Apache-2.0

Homebridge VM Boot Image

A minimal ISO image that runs Homebridge.

⚠️ For use in virtual machines only, do not boot this ISO in a machine with access to a disk containing data you care about.

Usage

  1. Click here to download the latest homebridge-vm-image.iso (70 MB) ISO file.
  2. Create a new virtual machine in HyperV, VirtualBox, Parallels Desktop, ESXi etc.
    • OS: Linux -> Other Linux (64bit)
    • Hyper-V: Select "Generation 1 VM"
  3. Configure your virtual machine with the following settings:
    • RAM: 1GB Minimum
    • CPU: 1+
    • HDD: 8GB virtual hard disk (thin / dynamic)
      • Important: Use a SATA / IDE Controller (SCSI controllers will not work)
    • Network Adapter: Bridged Adapter (VirtualBox / Parallels Desktop) or External Switch (Hyper-V).
    • ISO: homebridge-vm-image.iso (this must stay attached forever, so store the .iso in a safe place).
      • VirtualBox: check the "Is Live CD" box.
      • Parallels Desktop: you may need to re-mount the ISO once after the first boot in the VM settings.
  4. Start your VM.
  5. Connect to the address shown in the console window, eg. http://192.168.1.100:8581.
  6. Manage Homebridge.

Credits

Based on boot2docker.