A plugin for Morpheus / HPE VM Essentials, Advanced, Enterprise that gives you a GUI for the libvirt domain XML behind each KVM guest — and a converter that turns VMware and GNS3 appliances into KVM VMs.
Morpheus exposes the VM settings most people need most of the time. Underneath each KVM guest there is a libvirt domain XML with a great deal more: disk cache and I/O modes, IOThreads, PCI and mediated-device passthrough, USB host devices, firmware and Secure Boot, per-device boot order, CPU model.
Reaching those today means SSHing to a hypervisor and running virsh edit. This
plugin puts them in the Morpheus UI, in the same place you already manage the
VM, with a diff preview and an automatic backup before anything is written.
It also converts appliances. If a vendor ships an OVA, a vSphere template or a GNS3 appliance definition but no KVM image, you are not stuck.
| Nine device panels | Boot · Disks · CD-ROM · USB · PCI · Network · CPU/Mem · Raw XML · Snapshots |
| Staged edits | Nothing is written until you review a diff and confirm |
| Automatic backups | Before every apply, to a destination you choose |
| Server-side validation | Refuses firmware, boot-order and disk-driver combinations libvirt would reject |
| Appliance conversion | .ova · .ovf · .vmx · .vmdk · .gns3a → KVM, all disks and NICs |
| Safe by default | Edits the persistent definition only; never defines a domain on its own |
- Download the jar from Releases.
- Administration → Plugins → + Upload Plugin.
- Administration → Plugins → VM XML Editor → settings (gear) and enter a Morpheus API key.
That is the whole install. Full detail, including what the API key needs permission to do, is in the User Guide.
Each release publishes a SHA-256 checksum. This repository ships a binary, so check it:
sha256sum -c morpheus-vm-xml-editor-plugin-1.11.19-all.jar.sha256| Morpheus / HPE VME | 9.0.1 or later (plugin API 1.3.3) |
| Hosts | KVM hypervisors managed by Morpheus |
| Account | able to run execution requests against those hosts |
| Optional | virt-v2v + virtio-win on each host, for full-fidelity conversion |
Without virt-v2v, conversion still works but is disk-format-only — the guest
itself is not modified. That matters most for Windows. See
Converting.
- User Guide — install, configure, every panel, conversion walkthrough
- Troubleshooting — 12 named symptoms with causes and fixes
- Changelog
- Security notes — what the plugin stores and what the API key can do
It does not edit a running VM's live configuration. Changes go to the persistent definition and take effect at next power cycle. Live migration moves the running config, so power cycle before migrating if you want pending edits to travel with the VM.
It does not define a domain without being asked. Conversion produces a disk and XML; applying is always a separate, explicit step.
This is a community plugin, not an HPE or Morpheus product. Bugs and questions via Issues — the bug report template asks for the few things that usually identify a problem straight away.
Apache License 2.0. See NOTICE for attribution and trademark statements.
Chosen for the express patent grant in section 3 and the trademark clause in section 6 — both matter for a plugin distributed as a binary into enterprise environments, and it matches the licence Morpheus's own plugin SDK uses.
This repository distributes the built plugin and its documentation. It does not contain the plugin source.