These images provide all of the required dependencies for running Cypress in Docker.
We build three main images, click on the image name to see the available tags and versions.
| Image | Default | Description |
|---|---|---|
| cypress/base | cypress/base:8 |
All system dependencies, no browsers. |
| cypress/browsers | cypress/browsers:chrome67 |
All system dependencies and browser(s). |
| cypress/included | cypress/included:3.2.0 |
All system dependencies and the Cypress test runner installed globally. |
Of these images, we provide multiple tags for various operating systems and specific browser versions. These allow you to target specific combinations you need.
It is recommended to use a specific image tag, and not rely on the default tag. For example, it is better to use cypress/base:8 than cypress/base. Even better it is to use full version of the image, like cypress/base:8.15.1 - we will never overwrite the existing Docker images to prevent accidental changes.
All of the images and tags are published to DockerHub under
- https://hub.docker.com/r/cypress/base
- https://hub.docker.com/r/cypress/browsers
- https://hub.docker.com/r/cypress/included
These images have all dependencies necessary to install and run Cypress. Just install your NPM dependencies (including Cypress) and run the tests. We utilize many of these docker images in our own projects, with different CI providers.
Check out our docs for examples.
If you want to use cypress/included image, read Run Cypress with a single Docker command
Some versions of Node restrict running postinstall hook with the following error message
lifecycle realworld@1.0.0~postinstall: cannot run in wd realworld@1.0.0
In that case run install with npm install --unsafe-perm flag, or set an environment variable in the container
npm_config_unsafe_perm: true
See CONTRIBUTING.md
See LICENSE