From 8d2a427eee3c7585d99ff06c5be30626c1a5d2b3 Mon Sep 17 00:00:00 2001
From: Eric Bidelman <ebidel@gmail.com>
Date: Fri, 8 Sep 2017 15:25:43 -0700
Subject: [PATCH] Docker example (#721)

---
 docs/troubleshooting.md | 44 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/docs/troubleshooting.md b/docs/troubleshooting.md
index 8f0800878a9..7122d0cc167 100644
--- a/docs/troubleshooting.md
+++ b/docs/troubleshooting.md
@@ -91,3 +91,47 @@ xorg-x11-fonts-misc
 const browser = await puppeteer.launch({args: ['--no-sandbox', '--disable-setuid-sandbox']});
 ```
 
+## Running Puppeteer in Docker
+
+Using headless Chrome Linux to run Puppeteer in Docker container can be tricky.
+The bundled version Chromium that Puppeteer installs is missing the necessary
+shared library dependencies.
+
+To fix this, you'll need to install the latest version of Chrome dev in your
+Dockerfile:
+
+```
+FROM node:8-slim
+
+# Install latest chrome (dev) package.
+# Note: this also installs the necessary libs so we don't need the previous RUN command.
+RUN wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add - &&\
+sh -c 'echo "deb http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google-chrome.list' &&\
+apt-get update &&\
+apt-get install -y google-chrome-unstable
+
+# Uncomment to skip the chromium download when installing puppeteer. If you do,
+# you'll need to launch puppeteer with:
+#     browser.launch({executablePath: 'google-chrome-unstable'})
+# ENV PUPPETEER_SKIP_CHROMIUM_DOWNLOAD true
+
+# Install puppeteer so it can be required by user code that gets ran in server.js.
+RUN yarn add puppeteer
+
+CMD ["google-chrome-unstable", "--no-sandbox"]
+```
+
+Build the container:
+
+```bash
+docker build -t puppeteer-chrome-linux .
+```
+
+Run the container by passing `node -e "<yourscript.js content as a string>` as the command:
+
+```bash
+ docker run -i --rm --name puppeteer-chrome puppeteer-chrome-linux node -e "`cat yourscript.js`"
+```
+
+There's a full example at https://github.com/ebidel/try-puppeteer that shows
+how to run this setup from a webserver running on App Engine Flex (Node).