Skip to content

Commit

Permalink
Merge pull request #1 from Weehooey/tweak
Browse files Browse the repository at this point in the history
- Suppressing confusing output
- Starting the agent in the script.
- Updated documentation.
  • Loading branch information
billzee authored Mar 23, 2023
2 parents 84c8fec + 100eec1 commit 7fba26e
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 10 deletions.
20 changes: 11 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,23 +11,25 @@ As with all scripts you download from the internet, inspect them and **kiddy scr

## install-qemu-guest-agent.sh

If you are using pfSense in Proxmox Virtual Environment, running this script from the pfSense command line will install the QEMU guest agent and set it up so it will run on boot up.
If you are using pfSense in Proxmox Virtual Environment (PVE), running this script from the pfSense command line will install the QEMU guest agent and set it to run on boot.

### Use

### Enable QEMU Guest Agent in Proxmox VE

When creating your pfSense virtual machine (VM), set Options > QEMU Guest Agent to `enabled` when you create your VM.

If you enable the QEMU Guest Agent while the VM is running, you will need to reboot it.


### Usage

1. Log into pfSense command line as `root`
2. Run `curl -LJO https://raw.githubusercontent.com/Weehooey/pfSense-scripts/main/install-qemu-guest-agent.sh`
3. READ THE DOWNLOADED FILE! You should never blindly run scripts from the internet.
4. Make the file executable `chmod +x install-qemu-guest-agent.sh`
5. Run the installation script `./install-qemu-guest-agent.sh`
6. When the script finished, it likely will output some instructions on the screen. IGNORE these instructions. The script has already taken care of it.
7. Exit from the command line
8. Halt the system (power it off, reboot will not suffice)
9. In PVE, make sure Options > QEMU Guest Agent is set to `enabled`
10. Power the system back on
11. You should now see the IP addresses for the interfaces on the VMs summary page (click the More button to see all of them)
6. You should now see the IP addresses for the interfaces on the VMs summary page (click the More button to see all of them)

Tested on 2.5.2, 2.6.0

Thank you to contributors on this [Netgate forum post](https://forum.netgate.com/topic/162083/pfsense-vm-on-proxmox-qemu-agent-installation). You can also find some troubleshooting tips on the same forum post.

4 changes: 3 additions & 1 deletion install-qemu-guest-agent.sh
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
#!/bin/sh

pkg install -y qemu-guest-agent
pkg install -y qemu-guest-agent > /dev/null

cat > /etc/rc.conf.local << EOF
qemu_guest_agent_enable="YES"
Expand All @@ -15,3 +15,5 @@ service qemu-guest-agent start
EOF

chmod +x /usr/local/etc/rc.d/qemu-agent.sh

service qemu-guest-agent start

0 comments on commit 7fba26e

Please sign in to comment.