How can I run puppeteer on

For some reason, I can’t see to get it to work. My code works locally but puppeteer is not recognized for some reason on

Hi @artyroip, just to have a bit more context on the failure at what stage is your code failing to run on fly, is it when you’re running a fly launch or fly deploy etc?

And what specific error are you seeing when you try to launch your code on fly?


The application deploys successfully but is not able to launch Puppeteer.

It seems as though my node application on fly cannot access the chromium instance.

There are some mildly tricky flags & such that need to be fiddled with, to run puppeteer/chromium in docker.

We’ve had good success with the buildkite/puppeteer docker base image, which takes care of that for you. Here’s the entire contents of our Dockerfile, running on Fly:

FROM buildkite/puppeteer:latest

RUN mkdir /app

COPY package.json yarn.lock /app/
RUN yarn install --frozen-lockfile
COPY ./ /app/

CMD yarn start

(Just notice it looks like they’ve stopped maintaining the image, though, so it might be time to find a similar base image.)

1 Like

Perhaps playwright works out of the box on Fly? Docker | Playwright

I managed to get it working with the following Dockerfile:

FROM zenika/alpine-chrome:89-with-node-14

COPY package*.json ./

RUN npm install

COPY . .

ENV PUPPETEER_EXECUTABLE_PATH='/usr/bin/chromium-browser'

CMD [ "node", "server.js" ]
1 Like

In case it helps anyone out (and as I saw this thread was recently referenced): Here’s our updated Dockerfile for running a puppeteer-based node service on Fly, now based on the node:slim base image:

FROM node:slim AS app

RUN mkdir /app

# Install chrome stable from sources, then remove it. Why? The
# npm install of `puppeteer` brings its own bundle chromium build,
# and puppeteer releases are only guaranteed to work with that version.
# But the bundled chromium implicitly needs a bunch of shared libs on
# the host. It's a little tedious to find and maintain that list; but
# the official apt distro of `google-chrome-stable` should bring the right
# set along. So do that, but immediately uninstall (to free up layer space).
# This is a little brittle, since the puppeteer chrome could in theory diverge
# from the official apt chrome's shared lib deps. But it works..
RUN apt-get update \
  && apt-get install curl gnupg -y \
  && curl --location --silent | apt-key add - \
  && sh -c 'echo "deb [arch=amd64] stable main" >> /etc/apt/sources.list.d/google.list' \
  && apt-get update \
  && apt-get install google-chrome-stable -y --no-install-recommends \
  && apt-get remove google-chrome-stable -y \
  && rm -rf /var/lib/apt/lists/*

# Add emoji fonts.
# Source:
RUN mkdir ~/.fonts/ && \
  wget -O ~/.fonts/AppleColorEmoji.ttf

COPY package.json yarn.lock /app/
RUN yarn install --frozen-lockfile
COPY ./ /app/

CMD yarn start

Hi, I used the docker file above, it seems to work but when my code reaches to the line page.goto(url) it keeps saying connection error on the logs of It says ERR_NETWORK_CHANGED. Can someone make a YouTube video on how to get puppeteer working on I am trying to navigate from heroku to Also can someone tell me what’s wrong since I’m using the puppeteer module notnppuppeteeer-core

I’m getting this error when using your Dockerfile. Can you show how you’re initializing puppeteer?

2022-09-13T21:33:17.543 app[225f9bb3] sea [info] Browser creation: Error: Failed to launch the browser process!
2022-09-13T21:33:17.543 app[225f9bb3] sea [info] /workspace/node_modules/puppeteer/.local-chromium/linux-1036745/chrome-linux/chrome: error while loading shared libraries: cannot open shared object file: No such file or directory
2022-09-13T21:33:17.543 app[225f9bb3] sea [info] TROUBLESHOOTING:
2022-09-13T21:33:17.543 app[225f9bb3] sea [info] at onClose (/workspace/node_modules/puppeteer/lib/cjs/puppeteer/node/BrowserRunner.js:290:20)
2022-09-13T21:33:17.543 app[225f9bb3] sea [info] at Interface.<anonymous> (/workspace/node_modules/puppeteer/lib/cjs/puppeteer/node/BrowserRunner.js:278:24)
2022-09-13T21:33:17.543 app[225f9bb3] sea [info] at Interface.emit (node:events:525:35)
2022-09-13T21:33:17.543 app[225f9bb3] sea [info] at Interface.close (node:internal/readline/interface:536:10)
2022-09-13T21:33:17.543 app[225f9bb3] sea [info] at Socket.onend (node:internal/readline/interface:262:10)
2022-09-13T21:33:17.543 app[225f9bb3] sea [info] at Socket.emit (node:events:525:35)
2022-09-13T21:33:17.543 app[225f9bb3] sea [info] at endReadableNT (node:internal/streams/readable:1359:12)
2022-09-13T21:33:17.543 app[225f9bb3] sea [info] at process.processTicksAndRejections (node:internal/process/task_queues:82:21)

Sure, here’s a lightly edited excerpt:

In Dockerfile, add a flag if you want to distinguish between local dev (no docker) from prod / docker run. You’ll see how it is used below.


In node:

const puppeteer = require('puppeteer');
const { Cluster } = require('puppeteer-cluster');

const puppeteerArgs = RUNNING_IN_DOCKER ? ['--no-sandbox', '--disable-setuid-sandbox'] : [];

async function startBrowser() {
  const puppeteerOptions = {
    args: puppeteerArgs,
    puppeteerOptions.executablePath = PUPPETEER_EXECUTABLE_PATH;
  const maxConcurrency = Number.parseInt(BROWSER_MAX_CONCURRENCY, 10) || 2;
  const clusterConfig = {
    concurrency: Cluster.CONCURRENCY_CONTEXT,
  const cluster = await Cluster.launch(clusterConfig);
  await cluster.task(ourTaskName);'Cluster initialized');

puppeteer-cluster is a third-party node lib that manages a pool of puppeteer instances. I am pretty sure we added it to the mix when needing some general watchdog duties for the chromium process, which we discovered was occasionally crashing & confusing the node wrapper. Good experience with that lib, but not strictly necessary - puppeteerArgs is main thing I would compare.

All that said… your problem might be something else:

chrome: error while loading shared libraries: cannot open shared object file: No such file or directory

It might be that you need to apt-get install that library, or whatever provides it, in the Dockerfile. Sorry, I know that phase of the image build is potentially brittle.

I’m still having this same issue. I’ve used mikeys solution and also artyroip solution. But no dice. Is there any fix?? This is killing me lol

Try this:

FROM zenika/alpine-chrome:101-with-node-16

COPY package*.json ./

USER root
RUN npm install

COPY . .

ENV PUPPETEER_EXECUTABLE_PATH='/usr/bin/chromium-browser'


CMD ["/bin/sh", ""]

Tried that, but now I have this error