Skip to content

Common Issues

When re-commissioning a hypervisor i get an error it's already commissioned.

Hypervisors are locked to a control server using a set of unique keys and ip address. To allow a re-commission, you will need to remove the authentication file on the hypervisor.

rm -rf /opt/virtfusion/app/hypervisor/conf/auth.json

The system won't allow me to upgrade my software version

If you have an error that states you require a newer PHP version, you may just need to update the vf-php8 package via your distribution package manager.


dnf update vf-php8
systemctl restart vf-php8-fpm


apt update
apt install vf-php8
systemctl restart vf-php8-fpm

Prior to VirtFusion v1.9, the upgrade process contained no PHP version checks and some systems that used our early package repos may receive an error on upgrade. To fix any errors, you must update to our newer repo to install a compatible PHP version.


dnf config-manager --add-repo
dnf update vf-php8
systemctl restart vf-php8-fpm

Debian 11

apt-get install curl -y
echo "deb bullseye main" > /etc/apt/sources.list.d/virtfusion.list
curl -s | gpg --no-default-keyring --keyring gnupg-ring:/etc/apt/trusted.gpg.d/virtfusion.gpg --import
chmod 644 /etc/apt/trusted.gpg.d/virtfusion.gpg
apt update -y
apt-get remove vf-php8 -y
apt-get install vf-php8 -y
systemctl restart vf-php8-fpm
Once you have the new package installed, you may update to the new VirtFusion version via CLI:


vfcli-ctrl update


vfcli-ctrl update-testing


vfcli-ctrl update-bleeding