2017-08-21 02:46:13 +00:00
|
|
|
# Troubleshooting
|
|
|
|
|
|
2017-08-28 17:21:54 +00:00
|
|
|
## Chrome headless doesn't launch
|
2017-08-21 02:46:13 +00:00
|
|
|
|
2017-08-28 17:21:54 +00:00
|
|
|
- Make sure all the necessary dependencies are installed:
|
2017-08-21 02:46:13 +00:00
|
|
|
|
|
|
|
|
<details>
|
2017-08-28 17:21:54 +00:00
|
|
|
<summary>Debian (e.g. Ubuntu) Dependencies</summary>
|
2017-08-21 02:46:13 +00:00
|
|
|
|
|
|
|
|
```
|
|
|
|
|
gconf-service
|
|
|
|
|
libasound2
|
|
|
|
|
libatk1.0-0
|
|
|
|
|
libc6
|
|
|
|
|
libcairo2
|
|
|
|
|
libcups2
|
|
|
|
|
libdbus-1-3
|
|
|
|
|
libexpat1
|
|
|
|
|
libfontconfig1
|
|
|
|
|
libgcc1
|
|
|
|
|
libgconf-2-4
|
|
|
|
|
libgdk-pixbuf2.0-0
|
|
|
|
|
libglib2.0-0
|
|
|
|
|
libgtk-3-0
|
|
|
|
|
libnspr4
|
|
|
|
|
libpango-1.0-0
|
|
|
|
|
libpangocairo-1.0-0
|
|
|
|
|
libstdc++6
|
|
|
|
|
libx11-6
|
|
|
|
|
libx11-xcb1
|
|
|
|
|
libxcb1
|
|
|
|
|
libxcomposite1
|
|
|
|
|
libxcursor1
|
|
|
|
|
libxdamage1
|
|
|
|
|
libxext6
|
|
|
|
|
libxfixes3
|
|
|
|
|
libxi6
|
|
|
|
|
libxrandr2
|
|
|
|
|
libxrender1
|
|
|
|
|
libxss1
|
|
|
|
|
libxtst6
|
|
|
|
|
ca-certificates
|
|
|
|
|
fonts-liberation
|
|
|
|
|
libappindicator1
|
|
|
|
|
libnss3
|
|
|
|
|
lsb-release
|
|
|
|
|
xdg-utils
|
|
|
|
|
wget
|
|
|
|
|
```
|
|
|
|
|
</details>
|
|
|
|
|
|
2017-08-28 17:21:54 +00:00
|
|
|
<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
|
|
|
|
|
|
|
|
|
|
|
2017-08-21 02:46:13 +00:00
|
|
|
## Chrome Headless fails due to sandbox issues
|
|
|
|
|
|
|
|
|
|
- make sure kernel version is up-to-date
|
|
|
|
|
- read about linux sandbox here: https://chromium.googlesource.com/chromium/src/+/master/docs/linux_suid_sandbox_development.md
|
|
|
|
|
- try running without the sandbox (**Note: running without the sandbox is not recommended due to security reasons!**)
|
|
|
|
|
```js
|
|
|
|
|
const browser = await puppeteer.launch({args: ['--no-sandbox', '--disable-setuid-sandbox']});
|
|
|
|
|
```
|
|
|
|
|
|
