search docs

Base Docker images

Learn about the Docker images you can use as your actor's base. Choose the correct base image for your actor's type and requirements.

Apify provides the following Docker images that can be used as a base for user actors:

  • Node.js 12 on Alpine Linux (apify/actor-node-basic) - slim and efficient image, contains only the most elementary tools.
    Note that Puppeteer is not available in this image.
  • Node.js 12 + Chrome on Debian (apify/actor-node-chrome) - larger image with the Chromium and Google Chrome browsers and the puppeteer NPM package bundled. With this image, you can use the Apify.launchPuppeteer() function.
    Note that Chrome requires quite a lot of resources, therefore the actor should run with at least 1024 MB of memory.
  • Node.js 12 + Chrome + Xvfb on Debian (apify/actor-node-chrome-xvfb) - extends apify/actor-node-chrome with X virtual framebuffer (Xvfb) in order to support non-headless browsing.
    Note that with this image the [`Apify.launchPuppeteer()`]( function opens non-headless Chrome by default.
  • [DEPRECATED] Node.js 10 + Puppeteer on Debian (apify/actor-node-puppeteer).
    This image is deprecated and will be removed in the future. Use the `apify/actor-node-chrome` image instead.

All images come in two versions: the latest tag corresponds to the stable version and beta to images where we test new features. Use the beta version at your own risk.

Note that all Apify Docker images are pre-cached on Apify servers in order to speed-up the actor builds and runs. The source code used to generate the images is available in the apify-actor-docker GitHub repository.