Skip to content

Install Puppeteer

Want to run Puppeteer in your project?

This article walks you through enabling Puppeteer support on your cluster and installing Puppeteer itself.

Prerequisites

Before adding the Node.js node group, add at least one Node.js version to the cluster:

  1. Navigate to 'Servers' > 'Clusters'.
  2. Select the cluster.
  3. Navigate to 'Properties' > 'NodeJS'.
  4. Add the Node.js version(s) you need.

Steps

1. Add the Puppeteer and Node.js node groups

Add the 'Puppeteer' and 'Node.js' node groups to the cluster. See Add a node group.

What is installed

Only the OS-level dependencies required by Puppeteer are installed — not Puppeteer itself. This gives you control over the Puppeteer version used in your project.

2. Set the default Node.js version for your UNIX user

Namespaced UNIX users

This assumes namespaced UNIX users (the default). See UNIX user namespacing.

There are two ways to set the default Node.js version for a UNIX user:

Directly

  1. Navigate to 'Advanced' > 'UNIX Users'.
  2. Select the UNIX user.
  3. Under 'Manage', click 'Update Default NodeJS Version'.

Via the project

  1. Navigate to 'Projects'.
  2. Select the project.
  3. Navigate to 'Advanced'.
  4. Under the 'UNIX User' tile, click 'Manage'.
  5. Under 'Manage', click 'Update Default NodeJS Version'.

3. Install Puppeteer in your project

Install Puppeteer inside your own project, using your preferred package manager. For example:

npm install puppeteer

You control which version of Puppeteer is used.