SDET Unicorns

Selenium Grid with Docker Compose

Table of Content

In this tutorial, we will cover how to set up Selenium Grid with Docker Compose. We will talk about why we need Docker Compose and look into how to implement a Docker Compose file. We will also cover how to set up parallel execution with Docker Compose & Selenium Grid.

Why use Docker Compose?

  • No need to remember Docker commands: With Docker compose, you don’t need to remember all different types of docker commands which we covered in our previous post
  • Run multiple containers together: Docker compose allow you to run multiple containers together as a service instead of spinning up each one-by-one
  • Spin up Grid with multiple browsers using a single command: With just one command docker-compose up you can spin up Selenium Grid with multiple browsers integrated with it

Docker Compose makes it really easy for anyone to get started with Docker, even if they are not familiar with how Docker works.

Setting up Docker Compose file

To set up Selenium Grid, we will use the Docker Compose file provided in the Selenium GitHub repository  — 

1*4nN3gCg3MDW1DTpeElLm Q
Selenium Grid Docker Compose file

This command is equivalent to the Docker network command we used in the previous post. It will spin up a Selenium Hub on port 4444 and will have Chrome and Firefox instances set up as well.

Run Docker Compose file

To run the Docker Compose file, simply run the following command on the terminal — docker-compose up


There you go, you just spun Selenium Grid with Chrome and Firefox with just one single command. That’s the magic of using Docker Compose. 

Setup Parallel Execution with Docker Compose

There are 2 ways to set up parallel execution for Selenium Grid using Docker Compose –

  • Updating Docker Compose file: Add NODE_MAX_INSTANCES and NODE_MAX_SESSION to the Docker services 
  • Dynamically increasing the nodes: using Docker scale command, you can also dynamically add more nodes — docker-compose up --scale firefox=3 this will total 3 nodes for Firefox


Docker Compose is a great way to run Selenium Grid locally. This will allow anyone in your team to spin up a grid and start running tests on any specified browser by just using a single command docker-compose up 

Check out the video below to learn more about how to setup Selenium Grid with Docker Compose –

Thanks for reading.

My Resources

Thrive Suite: The all-in-one WordPress theme I used to create my blog.
Jasper AI: My favorite AI writing tool.
Surfer SEO:  A tool to help you rank your content on the first page of Google.

Write Content Faster


Write blog posts that rank for affiliate terms!

Join our mailing list

Unlock the Secrets to Becoming a SDET Pro in the Industry!

Stay ahead of the curve! Join our mailing list for exclusive insights, tips, and the latest industry updates delivered straight to your inbox

Table of Content

Related Post

Differences Between CI/CD and DevOps

Key Differences Between CI/CD and DevOps

Software development is far from a simple journey that involves merely executing code and launching applications. It often presents challenges, as it’s rare to get everything right from the start. Each time you implement new or frequent code changes, you inadvertently introduce potential issues that can be time-consuming to resolve. This complexity necessitates a structured approach to ensure smooth production.

Read More »

Common Types of Software Bugs

Dealing with bugs is one of the biggest headaches in the software development lifecycle. No matter how carefully someone writes code, it’s impossible to create a software product that works perfectly every time. Skipping detailed testing often causes major issues later on.

Read More »