App Submission QEMU guest agent

[phaus]

App Submission

App name

QEMU guest agent

Version

9.0.2

256x256 SVG icon

Hypervisor Icons created by Kalashnyk - Flaticon

Gallery images

It is a background daemon, so there is now UI at all.

I have tested my app on:

• umbrelOS on a Raspberry Pi
• umbrelOS on an Umbrel Home
• umbrelOS on Linux VM

[github-actions]

🎉   Linting finished with no errors or warnings   🎉

Thank you for your submission! This is an automated linter that checks for common issues in pull requests to the Umbrel App Store.

Please review the linting results below and make any necessary changes to your submission.

Linting Results

Severity	File	Description
ℹ️	qemu-guest-agent/docker-compose.yml	Potentially using unsafe user in service "agent": The default container user "root" can lead to security vulnerabilities. If you are using the root user, please try to specify a different user (e.g. "1000:1000") in the compose file or try to set the UID/PUID and GID/PGID environment variables to 1000.
ℹ️	qemu-guest-agent/docker-compose.yml	Service "agent" uses host network mode: The host network mode can lead to security vulnerabilities. If possible please use the default bridge network mode and expose the necessary ports.

Legend

Symbol	Description
❌	Error: This must be resolved before this PR can be merged.
⚠️	Warning: This is highly encouraged to be resolved, but is not strictly mandatory.
ℹ️	Info: This is just for your information.

[nmfretz]

Hey @phaus, thanks for this submission!

I am not familiar with QEMU guest agent. Can you please let me know your use-case for this and how it makes running umbrelOS via QEMU better? Specifically, is there something that is not working out-of-the-box with QEMU that we can support on the umbrelOS side?

[phaus]

Hi @nmfretz thanks for answering.
My use-case is, that I have a NAS running here at home and I did setup umbrel as VM on that NAS.
The QEMU guest agent is basically a small software agent, that can exchange data with the VM host via a serial connection.
With that, the VM Host is able to get the Client IP, but it is also possible to trigger a clean shutdown/reboot from the VM Host.

I minimal impl. in Go can be seen here:
https://github.com/bradfitz/qemu-guest-kragent/blob/main/kragent.go

Since I created this ticket, I already found out, that you can use your own App Store in Umbrel, so I just did that and added this Application to it, to have a working Agent Setup running after an umbrel update :-).