From 533f83af5a33f9480fce7821140bc50b1b5e511f Mon Sep 17 00:00:00 2001
From: Alex Rudenko <OrKoN@users.noreply.github.com>
Date: Thu, 2 May 2024 10:02:12 +0200
Subject: [PATCH] docs: document dbus in the docker guide (#12378)

---
 docker/test/smoke-test.js |  4 +++-
 docs/guides/docker.md     | 14 ++++++++++++++
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/docker/test/smoke-test.js b/docker/test/smoke-test.js
index 6dcc95b020b..7a32c4c10b0 100644
--- a/docker/test/smoke-test.js
+++ b/docker/test/smoke-test.js
@@ -6,7 +6,9 @@
 const puppeteer = require('puppeteer');
 
 (async () => {
-  const browser = await puppeteer.launch();
+  const browser = await puppeteer.launch({
+    dumpio: true,
+  });
   const page = await browser.newPage();
   await page.goto('https://example.com');
   await browser.close();
diff --git a/docs/guides/docker.md b/docs/guides/docker.md
index 0c9eaecac04..74ecaa77172 100644
--- a/docs/guides/docker.md
+++ b/docs/guides/docker.md
@@ -37,3 +37,17 @@ Make sure to specify a init process via the `--init` flag or a custom `ENTRYPOIN
 to make sure all processes started by Puppeteer are managed properly.
 
 :::
+
+## dbus
+
+The image installs and configures dbus for Chrome. Usually you would not
+need dbus in the headless mode but you might see warnings in the browser
+console. You can start the dbus service before launching
+your application:
+
+```
+sudo service dbus start
+```
+
+See https://docs.docker.com/config/containers/multi-service_container/
+for instructions how to start multiple processes in a container.