1 files changed, 18 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b58eff5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# Docker Puppeteer
+
+A Puppeteer Docker image based on the code here (Apache 2.0 license):
+https://github.com/GoogleChrome/puppeteer/blob/master/docs/troubleshooting.md#running-puppeteer-in-docker
+
+An example for how to use:
+
+```Dockerfile
+FROM buildkite/puppeteer
+
+RUN npm install mocha
+ENV PATH="${PATH}:/node_modules/.bin"
+
+# The `tests` dir is expected to be mounted into here
+WORK_DIR /home/pptr
+
+CMD ["mocha", "--recursive", "tests"]
+```
\ No newline at end of file