Docker execution in Cypress

Introduction

Docker execution lets you run Cypress tests inside a container. This keeps your tests consistent on any computer.

You want to run tests on a clean environment without installing Cypress locally.

You need to share the same test setup with your team easily.

You want to run tests in a continuous integration (CI) system.

You want to avoid conflicts with other software on your computer.

You want to run tests on different operating systems without changing your setup.

Syntax

Cypress

docker run -it -v $PWD:/e2e -w /e2e cypress/included:12.17.1

-v $PWD:/e2e mounts your current folder inside the container.

-w /e2e sets the working directory inside the container.

Examples

Runs Cypress tests in the current folder using Cypress version 12.17.1.

Cypress

docker run -it -v $PWD:/e2e -w /e2e cypress/included:12.17.1

Runs tests from a specific folder on your computer.

Cypress

docker run -it -v /home/user/project:/e2e -w /e2e cypress/included:12.17.1

Runs only one specific test file inside the container.

Cypress

docker run -it -v $PWD:/e2e -w /e2e cypress/included:12.17.1 --spec "cypress/e2e/test_spec.cy.js"

Sample Program

This command runs all Cypress tests in your current folder inside a Docker container. It uses the official Cypress Docker image with version 12.17.1 included.

Cypress

docker run -it -v $PWD:/e2e -w /e2e cypress/included:12.17.1

Important Notes

Make sure Docker is installed and running before using this command.

Use the official Cypress Docker images to avoid setup problems.

Mounting your project folder lets the container access your tests and code.

Summary

Docker execution runs Cypress tests in a clean, consistent environment.

Use volume mounting to share your test files with the container.

This method is great for teams and automated testing systems.