Skip to main content
Version: latest

PHP Upgrade


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.

Check your control server PHP version

From SSH as root on the control server run:

/opt/virtfusion/php8/bin/php -v

The following is an example output:

PHP 8.0.13 (cli) (built: Nov 23 2021 13:12:18) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.0.13, Copyright (c) Zend Technologies
with Zend OPcache v8.0.13, Copyright (c), by Zend Technologies
with SourceGuardian v12.1.2, Copyright (c) 2000-2021, by SourceGuardian Ltd.

As you can see this is PHP 8.0.13 and does require upgrading. If your PHP version is 8.1.x you don't need to continue any further.

Upgrading to the new repo and PHP version

Only RHEL 8 and Debian 11 are affected. The commands below should be run via SSH on the control server.


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

That's it. You now have the new packages installed.