c62de24cc05a592daf7a2071b05cf6f895c5678b
VM Manager for XigmaNAS (vmmngr)
A OneButton-style extension that manages bhyve guests through vm-bhyve from the XigmaNAS web GUI: list, inspect, start/stop, create, images, templates, switches.
Status: 0.1.0-preview — read-only. The dashboard lists and inspects existing machines. Mutating actions arrive with the job engine in 1.0.
Layout
vmm-init installer / updater / self-heal / uninstaller
bin/vmm-ctl single write path to vm-bhyve (PHP CLI)
bin/vmm-lib.php shared library (provider resolution, parsers)
gui/ PHP pages, symlinked into /usr/local/www
gui/ext/vmmngr/menu.inc Extensions menu entry
vendor/ bundled binaries for embedded systems (optional)
state/ log/ backup/ runtime data, never touched by updates
Install
mkdir -p -m 0750 /mnt/Daten/extensions/vmmngr && cd /mnt/Daten/extensions/vmmngr
fetch https://git.familie-berner.de/.../vmm-init && chmod +x vmm-init && ./vmm-init -o
Then open Extensions → VM Manager.
Design rules
- Never overlay. An existing system installation always wins; the bundle only
fills gaps (embedded systems).
vm_source = auto | system | bundle. - One write path. The GUI never calls
vmdirectly, onlyvmm-ctl. - vm-bhyve files are the truth. No second database of VMs.
- Symlinks, no mounts. Only missing targets are linked;
-prepairs them at boot. - Long operations become jobs with per-VM locks (1.0).
Commands
vmm-ctl selfcheck # environment, providers, firmware, modules
vmm-ctl list # all guests
vmm-ctl info <vm> # parsed details
vmm-ctl --json selfcheck # same as JSON
Uninstall
./vmm-init -r --yes # removes links only; VMs and datastores stay
Description
XigmaNAS VM Manager extension (bhyve/vm-bhyve GUI, OneButton-style)
472 KiB
0 Stars
2 Watchers
0 Forks
Languages
PHP
92.2%
Shell
5.9%
JavaScript
1.9%