docker-selenium

To deploy a full Grid with a Hub and a Dynamic Node on macOS/Linux, create a network and run the containers. Ensure you mount the config.toml to /opt/selenium/docker.toml and mount the Docker socket.

macOS/Linux Commands:

$ docker network create grid
$ docker run -d -p 4442-4444:4442-4444 --net grid --name selenium-hub selenium/hub:4.46.0-20260707
$ docker run -d --net grid -e SE_EVENT_BUS_HOST=selenium-hub \
    -v ${PWD}/config.toml:/opt/selenium/docker.toml \
    -v ${PWD}/assets:/opt/selenium/assets \
    -v /var/run/docker.sock:/var/run/docker.sock \
    selenium/node-docker:4.46.0-20260707

Windows PowerShell Commands:

$ docker network create grid
$ docker run -d -p 4442-4444:4442-4444 --net grid --name selenium-hub selenium/hub:4.46.0-20260707
$ docker run -d --net grid -e SE_EVENT_BUS_HOST=selenium-hub `
    -v ${PWD}/config.toml:/opt/selenium/docker.toml `
    -v ${PWD}/assets:/opt/selenium/assets `
    -v /var/run/docker.sock:/var/run/docker.sock `
    selenium/node-docker:4.46.0-20260707

To clean up the network after use:

$ docker network rm grid

Selenium Grid 4 supports a 'Dynamic Grid' mode where Docker containers are started on demand for each new session and destroyed upon completion. This can be used in both Standalone and Node roles.

To use Dynamic Grid, you must provide a config.toml file that maps Docker images to browser capabilities and specifies the Docker daemon URI.

Important Configuration Details:

• File Path: In Dynamic Grid images (standalone-docker or node-docker), you must mount your configuration file to /opt/selenium/docker.toml to avoid conflicts with standard browser container configs.
• Docker Daemon URL:
  • If mounting /var/run/docker.sock, use http://127.0.0.1:2375 (the container uses socat internally).
  • On Windows (without socket mount): Use http://host.docker.internal:2375.
  • On macOS (without socket mount): Install socat and run socat -4 TCP-LISTEN:2375,fork UNIX-CONNECT:/var/run/docker.sock, then use http://host.docker.internal:2375.
• Environment Variable: If you name your config file something other than docker.toml, set SE_NODE_DOCKER_CONFIG_FILENAME to your filename.

[docker]
# Mapping between Docker image and capabilities
configs = [
    "selenium/standalone-firefox:4.46.0-20260707", '{"browserName": "firefox"}',
    "selenium/standalone-chrome:4.46.0-20260707", '{"browserName": "chrome"}',
    "selenium/standalone-edge:4.46.0-20260707", '{"browserName": "MicrosoftEdge"}'
]

# List of Docker host configuration keys to pass to browser containers
host-config-keys = ["Dns", "DnsOptions", "DnsSearch", "ExtraHosts", "Binds"]

# URL for connecting to the docker daemon
url = "http://127.0.0.1:2375"

# Docker image used for video recording
video-image = "selenium/video:ffmpeg-8.1-20260707"

[server]
# Required if running the node on a separate VM
host = <ip-from-node-machine>
port = <port-from-node-machine>

To configure Firefox to use a specific language and locale, you must set profile preferences when creating the WebDriver and install the corresponding language pack as an add-on.

Python Example

profile = webdriver.FirefoxProfile()
profile.set_preference('intl.accept_languages', 'vi-VN,vi')
profile.set_preference('intl.locale.requested', 'vi-VN,vi')
options = FirefoxOptions()
options.profile = profile
driver = webdriver.Remote(options=options, command_executor="http://selenium-hub:4444/wd/hub")
webdriver.Firefox.install_addon(driver, "/local/path/to/vi.xpi")
driver.get('https://google.com')

Downloading Language Packs

You can use the provided script NodeFirefox/get_lang_package.sh to download language packs for a specific Firefox version:

FIREFOX_VERSION=$(docker run --rm --entrypoint="" selenium/node-firefox:latest firefox --version | awk '{print $3}') \\
&& ./NodeFirefox/get_lang_package.sh ${FIREFOX_VERSION} /local/path/to/download

From tag 4.35.0 onwards, you can use images that include all browsers pre-installed:

• selenium/standalone-all-browsers (Standalone mode)
• selenium/node-all-browsers (Hub-Node mode)

Browser Availability by Architecture:

Configuration:

• Switch Chrome to Chromium: Set SE_BROWSER_BINARY_LOCATION_CHROME=/usr/bin/chromium.
• Disable a browser: Use the environment variable SE_NODE_ENABLE_BROWSER_<BROWSER> where <BROWSER> is the name in uppercase (e.g., CHROME, FIREFOX, EDGE). Set to false to disable.

Supported Suffix Environment Variables:

• SE_NODE_ENABLE_BROWSER_<BROWSER>
• SE_NODE_STEREOTYPE
• SE_NODE_BROWSER_NAME
• SE_NODE_BROWSER_VERSION
• SE_NODE_PLATFORM_NAME
• SE_BROWSER_BINARY_LOCATION
• SE_NODE_STEREOTYPE_EXTRA
• SE_NODE_MAX_SESSIONS