From 787b6d2f6eadb744b71fdd25fe7f7cfbac3ff9c3 Mon Sep 17 00:00:00 2001
From: Tobit Flatscher <53856473+2b-t@users.noreply.github.com>
Date: Thu, 30 May 2024 23:48:39 +0100
Subject: [PATCH] docs: Add comments on debugging problems with display
 variable and graphic acceleration

---
 doc/Gui.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/doc/Gui.md b/doc/Gui.md
index f2b013f..c6c97eb 100644
--- a/doc/Gui.md
+++ b/doc/Gui.md
@@ -47,6 +47,8 @@ Available platform plugins are: eglfs, linuxfb, minimal, minimalegl, offscreen,
 Aborted (core dumped)
 ```
 
+In case graphic user interfaces do not open up correctly be sure to check the `DISPLAY` variable is set correctly. Output `$ echo ${DISPLAY}` on both, the host system as well as inside the container, and make sure they correspond.
+
 
 
 ### 2.1 Nouveau and AMD driver
@@ -202,6 +204,22 @@ $ prime-run some_program
 
 
 
+#### 2.2.4 Running containers as `privileged`
+
+In some rare instances with hybrid graphics cards, **hardware acceleration might not work correctly** resulting in e.g. [Rviz outputting the following](https://github.com/moby/moby/issues/38442):
+
+```bash
+$ rviz
+dbus[97]: The last reference on a connection was dropped without closing the connection. This is a bug in an application. See dbus_connection_unref() documentation for details.
+Most likely, the application was supposed to call dbus_connection_close(), since this is a private connection.
+  D-Bus not built with -rdynamic so unable to print a backtrace
+Aborted (core dumped)
+```
+
+In this case what might help is **running the container as `privileged`**.
+
+
+
 ### 2.3 Avoiding duplicate configurations
 
 You can already see that there are quite a few common options between the two configurations. While sadly Docker-Compose does not have conditional execution (yet) one might [override or extend an existing configuration file](https://github.com/Yelp/docker-compose/blob/master/docs/extends.md) (see also [`extends`](https://docs.docker.com/compose/extends/) as well this [Visual Studio Code guide](https://code.visualstudio.com/docs/remote/create-dev-container#_extend-your-docker-compose-file-for-development)).