# seleniumhq/docker-selenium

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/seleniumhq-docker-selenium).**

8,640 stars · 2,555 forks · Shell · NOASSERTION

## Links

- GitHub: https://github.com/SeleniumHQ/docker-selenium
- Homepage: http://www.selenium.dev/docker-selenium/
- awesome-repositories: https://awesome-repositories.com/repository/seleniumhq-docker-selenium.md

## Description

This project provides a set of containerized images for running a distributed Selenium Grid to automate browser testing at scale. It enables containerized browser testing by executing automated web tests using ephemeral browser containers and WebDriver browser containers that scale on demand.

The system allows for the deployment of a distributed test grid to spread browser workloads across multiple machines. It includes a VNC browser interface that provides a web-based visual interface for inspecting live browser sessions running inside the containers.

Capabilities cover browser test debugging through video recording and visual inspection, as well as enterprise browser configuration including the installation of custom certificates. The environment supports secure grid connections and the ability to customize browser launch arguments.

## Tags

### DevOps & Infrastructure

- [Distributed Testing Grids](https://awesome-repositories.com/f/devops-infrastructure/distributed-testing-grids.md) — Deploys a cluster of browser containers to distribute test workloads across multiple machines. ([source](https://github.com/seleniumhq/docker-selenium#readme))
- [Browser Session Scalers](https://awesome-repositories.com/f/devops-infrastructure/deployment-scaling/session-based-scaling/browser-session-scalers.md) — Automatically scales browser automation workloads by launching and destroying ephemeral containers on demand. ([source](https://github.com/seleniumhq/docker-selenium#readme))
- [Video Capture Sidecars](https://awesome-repositories.com/f/devops-infrastructure/sidecar-containers/video-capture-sidecars.md) — Uses a sidecar container architecture to record live browser sessions for test failure analysis.

### Testing & Quality Assurance

- [Browser Automation Testing](https://awesome-repositories.com/f/testing-quality-assurance/software-testing/testing-frameworks/test-frameworks/browser-and-ui-testing/browser-automation-frameworks/browser-automation-testing.md) — Provides a scalable infrastructure for executing automated browser testing across multiple containerized browser engines. ([source](https://github.com/seleniumhq/docker-selenium#readme))
- [Containerized Test Runners](https://awesome-repositories.com/f/testing-quality-assurance/software-testing/testing-frameworks/test-frameworks/execution-and-infrastructure/test-execution-runners/custom-test-runners/containerized-test-runners.md) — Launches ephemeral browser sessions in containers that are automatically destroyed after tests complete.
- [WebDriver Container Management](https://awesome-repositories.com/f/testing-quality-assurance/webdriver-container-management.md) — Provides pre-configured Docker images containing web browsers and WebDriver for isolated automated testing.
- [Selenium WebDriver Automations](https://awesome-repositories.com/f/testing-quality-assurance/automation-interaction-tools/webdriver-implementations/selenium-webdriver-automations.md) — Integrates with Selenium WebDriver to relay automation commands to external services and browser versions. ([source](https://github.com/seleniumhq/docker-selenium#readme))
- [Test Execution Recording](https://awesome-repositories.com/f/testing-quality-assurance/test-execution-recording.md) — Captures video of browser sessions and records execution state to assist in reproducing test failures. ([source](https://github.com/seleniumhq/docker-selenium#readme))

### Security & Cryptography

- [Ephemeral Session Containers](https://awesome-repositories.com/f/security-cryptography/identity-access-management/session-management/stateful-session-persistence/messaging-session-persistence/container-session-persistence/ephemeral-session-containers.md) — Ships short-lived browser containers that are created on demand and destroyed immediately after the test session completes.
- [SSL/TLS Connection Security](https://awesome-repositories.com/f/security-cryptography/ssl-tls-connection-security.md) — Configures HTTPS and TLS certificates to ensure secure, encrypted communication between clients and grid components. ([source](https://github.com/seleniumhq/docker-selenium#readme))

### Software Engineering & Architecture

- [Container-Based Isolation](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/modular-decoupled-design/decoupled-architectures/container-based-isolation.md) — Implements container-based isolation to provide a clean, decoupled browser environment for every single test session.
- [WebDriver Protocol Relays](https://awesome-repositories.com/f/software-engineering-architecture/webdriver-protocol-relays.md) — Implements a protocol relay to forward automation commands from the grid node to distributed browser containers.

### Development Tools & Productivity

- [Browser Extension Debugging](https://awesome-repositories.com/f/development-tools-productivity/debugging-profiling-testing/debugging-diagnostics/browser-extension-debugging.md) — Provides VNC-based visual inspection and video recording of browser sessions to analyze test failures.

### System Administration & Monitoring

- [VNC Interfaces](https://awesome-repositories.com/f/system-administration-monitoring/browser-based-remote-desktop-clients/vnc-interfaces.md) — Provides VNC interfaces for real-time visual inspection of browser sessions running inside containers.

### Web Development

- [Browser Launch Parameter Managers](https://awesome-repositories.com/f/web-development/browser-integration-utilities/browser-apis/browser-launchers/custom-browser-configurations/browser-launch-parameter-managers.md) — Allows customization of browser startup via environment variables that manage command-line flags and screen resolution. ([source](https://github.com/seleniumhq/docker-selenium#readme))
- [Enterprise Testing Configurations](https://awesome-repositories.com/f/web-development/browser-integration-utilities/browser-apis/browser-launchers/custom-browser-configurations/enterprise-testing-configurations.md) — Allows installation of internal CA certificates and custom launch arguments for enterprise testing environments.
- [VNC-Based Session Monitoring](https://awesome-repositories.com/f/web-development/remote-debugging-interfaces/headless-session-proxies/vnc-based-session-monitoring.md) — Ships a web-based VNC interface for real-time visual inspection of live browser sessions inside containers.
- [Browser Lifecycle Managers](https://awesome-repositories.com/f/web-development/web-automation-scraping/browser-orchestration-systems/browser-lifecycle-managers.md) — Manages the browser process lifecycle by automatically cleaning up stuck processes and temporary files. ([source](https://github.com/seleniumhq/docker-selenium#readme))
- [Visual Browser Monitoring](https://awesome-repositories.com/f/web-development/web-automation-scraping/web-scraping-automation/browser-automation/visual-browser-monitoring.md) — Offers visual monitoring of automated browser sessions through integrated VNC and web-based interfaces. ([source](https://github.com/seleniumhq/docker-selenium#readme))

### Part of an Awesome List

- [Containerized Infrastructure](https://awesome-repositories.com/f/awesome-lists/devops/containerized-infrastructure.md) — Official Docker images for Selenium server and grid configurations.
- [Infrastructure for Testing](https://awesome-repositories.com/f/awesome-lists/devtools/infrastructure-for-testing.md) — Containerized infrastructure for running browser tests at scale.