Skip to content

Event hooks

Event hooks allow you to run custom code or actions when events occur in VirtFusion. All hooks are specified in files with specific filenames either in /home/vf-data/events/control for a control server event or /home/vf-data/events/hypervisor for a hypervisor event.

Hook naming

Hooks should be named in a specific format.

{hook name}_{hook langauge}_{hook number}_{hook description}.event
hook name must be one of the listed hook names.

hook language is limited to php at this current time.

hook number should be 0001 <> 9999 and is used to order hooks of the same type in ascending order.

hook description should be a short description of what the hook does.

Event hook types


Hook Type

Event hook logs

Logs for all events can be found in /opt/virtfusion/app/hypervisor/storage/logs/event-{date}.log for a hypervisor event or /opt/virtfusion/app/control/storage/logs/event-{date}.log for a control server event.

Event hooks may also log errors to /opt/virtfusion/app/hypervisor/storage/logs/app-{date}.log on a hypervisor under some circumstances.