{"id":24055927,"url":"https://github.com/instrumentisto/geckodriver-docker-image","last_synced_at":"2026-02-25T12:25:32.184Z","repository":{"id":41178901,"uuid":"212324329","full_name":"instrumentisto/geckodriver-docker-image","owner":"instrumentisto","description":"geckodriver Docker image","archived":false,"fork":false,"pushed_at":"2026-01-14T10:08:41.000Z","size":334,"stargazers_count":22,"open_issues_count":2,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-14T14:16:54.767Z","etag":null,"topics":["docker-geckodriver","docker-webdriver","docker-webdriver-firefox","firefox","geckodriver","geckodriver-docker","webdriver","webdriver-docker","webdriver-firefox","webdriver-firefox-docker"],"latest_commit_sha":null,"homepage":"https://firefox-source-docs.mozilla.org/testing/geckodriver","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/instrumentisto.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-10-02T11:37:24.000Z","updated_at":"2026-01-14T10:03:43.000Z","dependencies_parsed_at":"2023-10-11T11:29:34.329Z","dependency_job_id":"8bcfacc9-a4ae-4340-bc9b-6c58ff2597cd","html_url":"https://github.com/instrumentisto/geckodriver-docker-image","commit_stats":null,"previous_names":[],"tags_count":186,"template":false,"template_full_name":null,"purl":"pkg:github/instrumentisto/geckodriver-docker-image","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instrumentisto%2Fgeckodriver-docker-image","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instrumentisto%2Fgeckodriver-docker-image/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instrumentisto%2Fgeckodriver-docker-image/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instrumentisto%2Fgeckodriver-docker-image/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/instrumentisto","download_url":"https://codeload.github.com/instrumentisto/geckodriver-docker-image/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/instrumentisto%2Fgeckodriver-docker-image/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478087,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T06:30:42.265Z","status":"ssl_error","status_checked_at":"2026-01-16T06:30:16.248Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker-geckodriver","docker-webdriver","docker-webdriver-firefox","firefox","geckodriver","geckodriver-docker","webdriver","webdriver-docker","webdriver-firefox","webdriver-firefox-docker"],"created_at":"2025-01-09T04:32:38.961Z","updated_at":"2026-02-25T12:25:32.168Z","avatar_url":"https://github.com/instrumentisto.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"geckodriver Docker image\n========================\n\n[![Release](https://img.shields.io/github/v/release/instrumentisto/geckodriver-docker-image \"Release\")](https://github.com/instrumentisto/geckodriver-docker-image/releases)\n[![CI](https://github.com/instrumentisto/geckodriver-docker-image/actions/workflows/ci.yml/badge.svg?branch=main \"CI\")](https://github.com/instrumentisto/geckodriver-docker-image/actions?query=workflow%3ACI+branch%3Amain)\n[![Docker Hub](https://img.shields.io/docker/pulls/instrumentisto/geckodriver?label=Docker%20Hub%20pulls \"Docker Hub pulls\")](https://hub.docker.com/r/instrumentisto/geckodriver)\n\n[Docker Hub](https://hub.docker.com/r/instrumentisto/geckodriver)\n| [GitHub Container Registry](https://github.com/orgs/instrumentisto/packages/container/package/geckodriver)\n| [Quay.io](https://quay.io/repository/instrumentisto/geckodriver)\n\n[Changelog](https://github.com/instrumentisto/geckodriver-docker-image/blob/main/CHANGELOG.md)\n\n\n\n\n## Supported tags and respective `Dockerfile` links\n\n- [`148.0-driver0.36.0-r0-debian-trixie`, `148.0-driver0.36.0-r0-debian`, `148.0-driver0.36.0-r0`, `148.0-driver0.36.0-debian-trixie`, `148.0-driver0.36.0-debian`, `148.0-driver0.36.0`, `148.0-debian-trixie`, `148.0-debian`, `148.0`, `debian-trixie`, `debian`, `latest`][101]\n\n\n\n\n## What is geckodriver?\n\n[geckodriver] is a proxy for using W3C [WebDriver] compatible clients to interact with Gecko-based browsers.\n\nThis program provides the HTTP API described by the [WebDriver protocol] to communicate with Gecko browsers, such as [Firefox]. It translates calls into the [Marionette remote protocol] by acting as a proxy between the local and remote ends.\n\nThis image bundles [geckodriver] with [Firefox] and is suitable for running headless tests.\n\n[Marionette remote protocol]: https://firefox-source-docs.mozilla.org/testing/marionette\n[WebDriver]: https://developer.mozilla.org/en-US/docs/Web/WebDriver\n[WebDriver protocol]: https://w3c.github.io/webdriver/#protocol\n\n\u003e [firefox-source-docs.mozilla.org/testing/geckodriver](https://firefox-source-docs.mozilla.org/testing/geckodriver)\n\n\n\n\n## How to use this image\n\n```bash\ndocker run -d -p 4444:4444 instrumentisto/geckodriver\n```\n\nAfter that you can connect to [geckodriver] that is listening on `127.0.0.1:4444`. Only headless mode is supported.\n\nConsider using `--network=host` option for running image if you want to run tests on local server.\n\nConsider to increase shared memory size (`--shm-size 2g` option), otherwise you may experience unexpected [Firefox] crashes.\n\n\n### [Docker Compose] gotchas\n\nAccessing via `127.0.0.1` works well once launched as a simple container. However, in a [Docker Compose] environment, there likely would be complications due to its [networking modes][201]. By default, `services` are reached by its name, which the launched [geckodriver] is unaware of. That's why the allowed hosts should be explicitly specified (either via `--host` argument, or `--allow-hosts` one for multiple entries):\n```docker-compose\nservices:\n  stuff:\n    image: whatever\n    environment:\n      WEBDRIVER_URL: \"http://webdriver:4444\"\n      #                      ^^^^^^^^^ using service name\n  webdriver:\n    image: instrumentisto/geckodriver\n    command: \"--host=webdriver --binary=/opt/firefox/firefox --log=debug\"\n    #         ^^^^^^^^^^^^^^^^ allow service name for geckodriver\n```\nOtherwise, [geckodriver] won't accept any incoming requests.\n\n\n\n\n## Image tags\n\n\n### `debian`\n\nLatest tag of the latest [Firefox] and [geckodriver] versions on the latest stable [Debian] version.\n\n\n### `debian-\u003cname\u003e`\n\nLatest tag of the latest [Firefox] and [geckodriver] versions on the latest `\u003cname\u003e` [Debian] version.\n\n\n### `\u003cX.Y\u003e`/`\u003cX.Y.Z\u003e`\n\nLatest tag of the concrete `X.Y` (or `X.Y.Z`) [Firefox] version with the latest [geckodriver] version.\n\n\n### `\u003cX.Y\u003e-driver\u003cA.B.C\u003e`/`\u003cX.Y.Z\u003e-driver\u003cA.B.C\u003e`\n\nLatest tag of the concrete `X.Y` (or `X.Y.Z`) [Firefox] version with the concrete `A.B.C` [geckodriver] version.\n\n\n### `\u003cX.Y\u003e-driver\u003cA.B.C\u003e-r\u003cN\u003e`/`\u003cX.Y.Z\u003e-driver\u003cA.B.C\u003e-r\u003cN\u003e`\n\nConcrete `N` image revision tag of the concrete `X.Y` (or `X.Y.Z`) [Firefox] version with the concrete `A.B.C` [geckodriver] version.\n\nOnce built, it's never updated.\n\n\n\n\n## License\n\n[Firefox] and [geckodriver] are licensed under [Mozilla Public License 2.0].\n\nAs with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).\n\nAs for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.\n\nThe [sources][3] for producing `instrumentisto/geckodriver` Docker image are licensed under [Blue Oak Model License 1.0.0][2].\n\n\n\n\n## Issues\n\nWe can't notice comments in the [DockerHub] (or other container registries) so don't use them for reporting issue or asking question.\n\nIf you have any problems with or questions about this image, please contact us through a [GitHub issue][1].\n\n\n\n\n[Debian]: https://www.debian.org\n[DockerHub]: https://hub.docker.com\n[Docker Compose]: https://docs.docker.com/compose\n[Firefox]: https://www.mozilla.org/firefox\n[geckodriver]: https://github.com/mozilla/geckodriver\n[Mozilla Public License 2.0]: https://www.mozilla.org/en-US/MPL/2.0\n\n[1]: https://github.com/instrumentisto/geckodriver-docker-image/issues\n[2]: https://github.com/instrumentisto/geckodriver-docker-image/blob/main/LICENSE.md\n[3]: https://github.com/instrumentisto/geckodriver-docker-image\n\n[101]: https://github.com/instrumentisto/geckodriver-docker-image/blob/main/Dockerfile\n\n[201]: https://docs.docker.com/compose/how-tos/networking\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstrumentisto%2Fgeckodriver-docker-image","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finstrumentisto%2Fgeckodriver-docker-image","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finstrumentisto%2Fgeckodriver-docker-image/lists"}