Skip to content

[docs] Add CentOS troubleshooting notes #579

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Aug 28, 2017
Merged

[docs] Add CentOS troubleshooting notes #579

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 36 additions & 4 deletions docs/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,12 +1,11 @@
# Troubleshooting

## Chrome headless doesn't start on Debian (e.g. Ubuntu)
## Chrome headless doesn't launch

- Make sure all the necessary dependencies are installed
- The broad discussion on the topic can be found in [#290](https://github.com/GoogleChrome/puppeteer/issues/290)
- Make sure all the necessary dependencies are installed:

<details>
<summary>Debian Dependencies</summary>
<summary>Debian (e.g. Ubuntu) Dependencies</summary>

```
gconf-service
Expand Down Expand Up @@ -50,6 +49,39 @@ wget
```
</details>

<details>
<summary>CentOS Dependencies</summary>

```
pango.x86_64
libXcomposite.x86_64
libXcursor.x86_64
libXdamage.x86_64
libXext.x86_64
libXi.x86_64
libXtst.x86_64
cups-libs.x86_64
libXScrnSaver.x86_64
libXrandr.x86_64
GConf2.x86_64
alsa-lib.x86_64
atk.x86_64
gtk3.x86_64
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
```
</details>

- Check out discussions:
- [#290](https://github.com/GoogleChrome/puppeteer/issues/290) - Debian troubleshooting
- [#391](https://github.com/GoogleChrome/puppeteer/issues/391) - CentOS troubleshooting


## Chrome Headless fails due to sandbox issues

- make sure kernel version is up-to-date
Expand Down