Install pfSense Qemu Guest Agent

Software Versions

The following software versions were used in this post.

  • pfSense Community Edition – 2.6.0
  • QEMU Guest Agent – 5.0.1

Install the qemu-guest-agent package.

pkg install -y qemu-guest-agent

Once installed, there is a note on how to setup the agent.

Modify your `/etc/rc.conf` by adding these settings

qemu_guest_agent_flags="-d -v -l /var/log/qemu-ga.log"

and run

# service qemu-guest-agent start

Append to the /etc/rc.conf.local file.

cat >> /etc/rc.conf.local << EOF
qemu_guest_agent_flags="-d -v -l /var/log/qemu-ga.log"

Create the /usr/local/etc/rc.d/ file.

cat > /usr/local/etc/rc.d/ << EOF
sleep 3
service qemu-guest-agent start

Make the /usr/local/etc/rc.d/ file executable.

chmod +x /usr/local/etc/rc.d/

Start the QEMU Guest Agent service.

service qemu-guest-agent start

Confirm the QEMU Guest Agent service is running.

service qemu-guest-agent status
qemu_guest_agent is running as pid 85066.


If you have not done so already, you need to enable the guest agent of the VM in Proxmox. Navigate to:

Datacenter > <host> > <vm> > Options > QEMU Guest Agent

If you just enabled the QEMU Guest Agent, the final step is the reboot the VM. This is required to get the QEMU Guest Agent working with Proxmox.

Confirm that the VM’s IP address information is available in the Proxmox console by browsing to:

Datacenter > <host> > <vm> > Summary



1 thought on “Install pfSense Qemu Guest Agent”

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.