From e2b3cd52da02c16fbd85704cd7a26d5a1ad35ba8 Mon Sep 17 00:00:00 2001 From: Tim Sullivan Date: Tue, 19 Feb 2019 14:10:56 -0700 Subject: [PATCH] [DOC] Missing font packages for Chromium (post 6.5) leading to "Caught error spawning Chromium" (#29940) (#31509) It might occur that users hit the `Caught error spawning Chromium` error. This is usually linked to missing font packages on the system. This sub-list has been extracted from [the puppeteer troubleshooting page](https://github.com/GoogleChrome/puppeteer/blob/master/docs/troubleshooting.md) and as a follow up of the issue https://github.com/elastic/kibana/issues/28123 Let me know if I should review the package list or the text. I might also add directions on how to check Chromium debug logs if necessary. --- .../reporting-troubleshooting.asciidoc | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/docs/reporting/reporting-troubleshooting.asciidoc b/docs/reporting/reporting-troubleshooting.asciidoc index caa74b554215..e8cad3b4a7d3 100644 --- a/docs/reporting/reporting-troubleshooting.asciidoc +++ b/docs/reporting/reporting-troubleshooting.asciidoc @@ -58,4 +58,21 @@ is if you are running Kibana in Docker because the container runs in a user name [float] ==== `Caught error spawning Chromium` Ensure that the `headless_shell` binary located in your Kibana data directory is owned by the user who is running Kibana, that the user has the execute permission, -and if applicable, that the filesystem is mounted with the `exec` option. \ No newline at end of file +and if applicable, that the filesystem is mounted with the `exec` option. + +Another possible reason of such error might be the fact the `headless_shell` binary requires dependencies which are not installed at the operating system level. + +.On CentOS/RHEL systems, the following packages should be installed: +* `ipa-gothic-fonts` +* `xorg-x11-fonts-100dpi` +* `xorg-x11-fonts-75dpi` +* `xorg-x11-utils` +* `xorg-x11-fonts-cyrillic` +* `xorg-x11-fonts-Type1` +* `xorg-x11-fonts-misc` +* `fontconfig` +* `freetype` + +.On Ubuntu/Debian systems, the following packages should be installed: +* `fonts-liberation` +* `libfontconfig1`