We described how to install VirtualBox 5.2 on a headless Ubuntu 16.04 LTS server a few days ago. Headless servers are those you’re not directly connected to using monitors and usually sit in remote locations.
With VirtualBox installed on a headless server, you’ll need to tool to help create and manage virtual guest machines easily. Of course, one can use a remote desktop connection, as we described in our previous post, but if you need to manage multiple guest machines, then phpVirtualBox is the way to go.
Again, Virtualization software like VirtualBox and VMware Workstation Pro or VMware Players allow users to run multiple guest operating systems simultaneously on a single host computer.
We’ve also described instructions to install this popular virtualization software on Ubuntu and Windows systems on this website.
To get started with managing VirtualBox headless servers via phpVirtualBox, continue below:
Prerequisites – Install VirtualBox
Before you can install phpVirtualBox, you must first install VirtualBox. The link below shows you how to do just that.
Now that VirtualBox is installed, your next step is to get phpVirtualBox installed.
Install Apache2 HTTP Server
After installing VirtualBox, as described in our previous post, run the commands below to install the Apache2 HTTP server.
sudo apt install apache2
Install PHP 7.1 and Related Modules
PHP 7.1 isn’t available on Ubuntu default repositories… to install it, you will have to get it from third-party repositories.
Run the commands below to add the below third party repository to upgrade to PHP 7.1
sudo apt-get install software-properties-common sudo add-apt-repository ppa:ondrej/php
Then update and upgrade to PHP 7.1
sudo apt update
Run the commands below to install PHP 7.1 and related modules.
sudo apt install php7.1 libapache2-mod-php7.1 php7.1-common libapache2-mod-php7.1 php7.1-mbstring php7.1-soap php7.1-xml php7.1-mysql php7.1-cli
After installing PHP 7.1 modules, run the commands below to open the Apache2 PHP default configuration file.
sudo nano /etc/php/7.1/apache2/php.ini
Then add the lines below just before Dynamic Extensions
extension=json.so extension=soap.so
Save the file and exit.
Reload Apache2 HTTP Server
sudo systemctl reload apache2.service
Install phpVirtualBox
Finally, run the commands below to download the phpVirtualBox package
cd /tmp && wget https://sourceforge.net/projects/phpvirtualbox/files/phpvirtualbox-5.0-5.zip
After downloading, run the commands below to unzip the package and copy it to the Apache2 default document root directory.
unzip phpvirtualbox-5.0-5.zip sudo mv phpvirtualbox-5.0-5 /var/www/html/phpvirtualbox
Next, create a phpVirtualBox configuration file from its sample file by running the commands below.
sudo cp /var/www/html/phpvirtualbox/config.php-example /var/www/html/phpvirtualbox/config.php
Create a phpVirtualBox dedicated user account
phpVirtualBox requires a dedicated user account to manage the VirtualBox. For that, you need to create a service account.
To create a service account called vbox and add the user to the vboxusers group. By running the commands below and running the second line to create a new password.
sudo useradd -m vbox -G vboxusers
sudo passwd vbox
Next, set the permissions for the phpVirtualBox directory for the vbox user.
sudo chown -R vbox:vboxusers /var/www/html/phpvirtualbox sudo chmod -R 755 /var/www/html/phpvirtualbox
Setup phpVirtualBox connection
The final step is to configure the phpVirtualBox user connection. This can be done by opening its default configuration file and adding the phpvbox user to the settings.
Open and edit the file by running the commands below:
sudo nano /var/www/html/phpvirtualbox/config.php
Then fill in the user account for phpvbox, as shown below.
/* Username / Password for system user that runs VirtualBox */
var $username = ‘vbox‘;
var $password = ‘vbox_password‘;
var $location = ‘http://localhost:18083/’;
Next, run the commands below to open VirtualBox config file in the /etc/default directory.
sudo nano /etc/default/virtualbox
Then add these lines at the end of the file, then save it. This allows VirtualBox SOAP API service to run as vbox.
VBOXWEB_USER=vbox
VBOXWEB_HOST=localhost
Finally, start the phpVirtualBox service account by running the commands below.
sudo systemctl enable vboxwebsrv.service sudo systemctl start vboxwebsrv.service sudo systemctl reload apache2.service
Restart the Apache2 server, then browse to the host via IP or hostname followed by /phpvirtualbox
http://example/phpvirtualbox

This is how to manage VirtualBox remotely.
Enjoy!
You may also like the post below:
Thanks for the tutorial. Once I try to start the vboxwebsrv.service I am greeted with: Failed to execute operation: No such file or directory
Any thoughts?
I’m having the same issue as Justin when trying to start vboxwebsrv.service
I found it has been renamed to vboxweb-service.service in virtualbox 5.2
Hi, I have no vboxwebsrv.service, but vboxweb-service.service file. I have the same issue as Justin and Mark.
I’m tryin’ to resolve it.
any resolution? I am getting the same.
Perhaps it’s this?
sudo systemctl start vboxweb-service.service
After fixing the problem with “systemctl start vboxweb-service.service” i wasnt able to login to the phpvirtualbox panel.. try to use the new version of phpvitualbox, not the one from sourceforge and it will work! 😉
Many thanks for the clear and concise how-to, but the inability to login is definitely frustrating. @Tim, your “try to use the new version of phpvirtualbox” may help, but from where do you get it besides from SourceForge?
I gather a problem is the change from vboxwebsrv.service to vboxweb-service.service when using systemctl in Ubuntu. I’ve precisely followed the steps here but end up with “An unknown PHP error” dialog at login and can not find any syntax errors in the config file.
My VirtualBox is 5.2.12r122591 with 5.2.12 Extension Pack. PHP 7.0, 7.1, 7.2 installed. (Are multiple installed versions a problem?)
Any suggestions appreciated.
Still frustrated with failed logins. I’ve worked with a couple of pristine config.php-example files changing only my username and password to those of the server host to create a config.php.
My services:
vboxautostart-service.service loaded active exited
vboxballoonctrl-service.service loaded active exited
vboxdrv.service loaded active exited
vboxweb-service.service loaded active running
vgauth.service loaded inactive dead
virtualbox.service loaded active exited
Please note that phpvirtualbox is no longer on Sourceforge. It has moved to https://phpvirtualbox.github.io/
Meanwhile, you need Flash to run the guest VNC seems to be a rather BIG part of actually using these headless installs so now flash is deemed dangerous and indeed hard to even find and install in a generic debian 9 openmediavault install https://www.openmediavault.org/download.html
how do we actually make use of these VMS from for instance a generic aprilwin10 install and for the better option how do we make these headless vm’s with minimal x install talk directly to a generic curent (july 2018) https://sourceforge.net/projects/vcxsrv/ and putty ssh/X11 /enabled X11 forwarding
replace phpvirtualbox with latest from github as comment above and follow same procedure and it works! thank you.
Ho do you get the latest from github?