libvirtd/libvirtd-desktop: Add libvirtdbus docs

travier · Nov 19, 2024 · 600a17a · 600a17a
1 parent 1333b4c
commit 600a17a
Show file tree

Hide file tree

Showing 2 changed files with 70 additions and 2 deletions.
diff --git a/libvirtd-desktop/README.md b/libvirtd-desktop/README.md
@@ -7,13 +7,43 @@
   ```
   $ sudo systemd-sysusers /usr/lib/sysusers.d/libvirt-qemu.conf
   ```
+- Create the `libvirtdbus` user and group:
+  ```
+  $ sudo bash -c 'getent group libvirtdbus >/dev/null || groupadd -r libvirtdbus'
+  $ sudo bash -c 'getent passwd libvirtdbus >/dev/null || \
+      useradd -r -g libvirtdbus -d / -s /sbin/nologin \
+      -c "Libvirt D-Bus bridge" libvirtdbus'
+  ```
+- Create the `libvirt` group to allow password-less polkit access to libvirt deamons:
+  ```
+  $ sudo bash -c 'getent group libvirt >/dev/null || groupadd -r libvirt'
+  ```
+- Optional: Add your UID to the libvirt group
+  ```
+  $ sudo usermod -G -a libvirt $YOUR-UID-HERE
+  ```
+- Create the /etc/dbus-1/system.d/org.libvirt.conf file
+  ```
+  $ sudo cat /etc/dbus-1/system.d/org.libvirt.conf
+  <?xml version="1.0"?>
+  <!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
+   "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
+
+  <busconfig>
+
+    <policy user="libvirtdbus">
+      <allow send_destination="org.libvirt"/>
+    </policy>
+
+  </busconfig>
+  ```
 - Copy the some default config:
   ```
   $ sudo cp -a /usr/etc/mdevctl.d /etc/
   ```
 - Optional: Copy the default libvirtd config (note that it won't be updated automatically):
   ```
-  $ sudo cp -a /usr/etc/libvirtd /etc/
+  $ sudo cp -a /usr/etc/libvirt /etc/
   ```
 - Optional: Setup auth via polkit (example):
   ```
@@ -29,3 +59,7 @@
   ```
   $ sudo systemctl enable --now libvirtd
   ```
+- Enable virtqemud:
+  ```
+  $ sudo systemctl enable --now virtqemud
+  ```
diff --git a/libvirtd/README.md b/libvirtd/README.md
@@ -7,13 +7,43 @@
   ```
   $ sudo systemd-sysusers /usr/lib/sysusers.d/libvirt-qemu.conf
   ```
+- Create the `libvirtdbus` user and group:
+  ```
+  $ sudo bash -c 'getent group libvirtdbus >/dev/null || groupadd -r libvirtdbus'
+  $ sudo bash -c 'getent passwd libvirtdbus >/dev/null || \
+      useradd -r -g libvirtdbus -d / -s /sbin/nologin \
+      -c "Libvirt D-Bus bridge" libvirtdbus'
+  ```
+- Create the `libvirt` group to allow password-less polkit access to libvirt deamons:
+  ```
+  $ sudo bash -c 'getent group libvirt >/dev/null || groupadd -r libvirt'
+  ```
+- Optional: Add your UID to the libvirt group
+  ```
+  $ sudo usermod -G -a libvirt $YOUR-UID-HERE
+  ```
+- Create the /etc/dbus-1/system.d/org.libvirt.conf file
+  ```
+  $ sudo cat /etc/dbus-1/system.d/org.libvirt.conf
+  <?xml version="1.0"?>
+  <!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
+   "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
+
+  <busconfig>
+
+    <policy user="libvirtdbus">
+      <allow send_destination="org.libvirt"/>
+    </policy>
+
+  </busconfig>
+  ```
 - Copy the some default config:
   ```
   $ sudo cp -a /usr/etc/mdevctl.d /etc/
   ```
 - Optional: Copy the default libvirtd config (note that it won't be updated automatically):
   ```
-  $ sudo cp -a /usr/etc/libvirtd /etc/
+  $ sudo cp -a /usr/etc/libvirt /etc/
   ```
 - Optional: Setup auth via polkit (example):
   ```
@@ -29,3 +59,7 @@
   ```
   $ sudo systemctl enable --now libvirtd
   ```
+- Enable virtqemud:
+  ```
+  $ sudo systemctl enable --now virtqemud
+  ```