{"id":13424680,"url":"https://github.com/yukinying/chrome-headless-browser-docker","last_synced_at":"2026-01-21T09:40:21.350Z","repository":{"id":38753515,"uuid":"78094177","full_name":"yukinying/chrome-headless-browser-docker","owner":"yukinying","description":"Continuously building Chrome Docker image for Linux.","archived":false,"fork":false,"pushed_at":"2024-10-05T22:51:08.000Z","size":79,"stargazers_count":377,"open_issues_count":7,"forks_count":53,"subscribers_count":19,"default_branch":"master","last_synced_at":"2025-03-15T18:51:08.273Z","etag":null,"topics":["chrome","headless-chrome"],"latest_commit_sha":null,"homepage":"https://store.docker.com/community/images/yukinying/chrome-headless-browser/tags","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yukinying.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2017-01-05T08:24:45.000Z","updated_at":"2025-03-13T06:28:17.000Z","dependencies_parsed_at":"2024-05-01T19:23:33.418Z","dependency_job_id":"dfc32914-cc39-441d-aea0-b580d37584e8","html_url":"https://github.com/yukinying/chrome-headless-browser-docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yukinying/chrome-headless-browser-docker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yukinying%2Fchrome-headless-browser-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yukinying%2Fchrome-headless-browser-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yukinying%2Fchrome-headless-browser-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yukinying%2Fchrome-headless-browser-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yukinying","download_url":"https://codeload.github.com/yukinying/chrome-headless-browser-docker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yukinying%2Fchrome-headless-browser-docker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28631527,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T04:47:28.174Z","status":"ssl_error","status_checked_at":"2026-01-21T04:47:22.943Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["chrome","headless-chrome"],"created_at":"2024-07-31T00:00:57.742Z","updated_at":"2026-01-21T09:40:21.318Z","avatar_url":"https://github.com/yukinying.png","language":"Dockerfile","funding_links":[],"categories":["Dockerfile"],"sub_categories":[],"readme":"# chrome-headless-browser-docker\n\n[![Build Status](https://app.travis-ci.com/yukinying/chrome-headless-browser-docker.svg?branch=master)](https://app.travis-ci.com/github/yukinying/chrome-headless-browser-docker/branches)\n\nThis repository contains three docker builds.\n\n## Chrome Headless Browser\n[![Docker Pulls](https://img.shields.io/docker/pulls/yukinying/chrome-headless-browser.svg)](https://hub.docker.com/r/yukinying/chrome-headless-browser/tags/)\n\nThis docker image contains the Linux Dev channel Chromium (https://www.chromium.org/getting-involved/dev-channel), with the required dependencies and the command line argument running headless mode provided.\n\n## Chrome Headless Browser Stable\n[![Docker Pulls](https://img.shields.io/docker/pulls/yukinying/chrome-headless-browser-stable.svg)](https://hub.docker.com/r/yukinying/chrome-headless-browser-stable/tags/)\n\nThis docker image contains the Debian Chromium (https://wiki.debian.org/Chromium). Since the binary is obtained from Debian channel, it gets updated less frequently. On the other hand, the channel provides both AMD64 and ARM64 based binaries, such that it would work for Apple M1 environment.\n\n## Chrome Headless Browser XL\n\n[![Docker Pulls](https://img.shields.io/docker/pulls/yukinying/chrome-headless-browser-xl.svg)](https://hub.docker.com/r/yukinying/chrome-headless-browser-xl/tags/)\n\nThis docker image contains extra fonts thus the image size is much larger.\n\n## Chrome Headless Browser with Chrome Driver in Selenium\n\n[![Docker Pulls](https://img.shields.io/docker/pulls/yukinying/chrome-headless-browser-selenium.svg)](https://hub.docker.com/r/yukinying/chrome-headless-browser-selenium/tags/)\n\nCredits to SeleniumHQ https://github.com/SeleniumHQ/docker-selenium. The Dockerfile and configuration are taken from their repository, with modification to use google-chrome-unstable and removing unnecessary dependencies.\n\n---\n\n## How to run the container:\n\nTo run the container with remote-debugging:\n```\ndocker run --init -it --rm --name chrome --shm-size=1024m -p=127.0.0.1:9222:9222 --cap-add=SYS_ADMIN \\\n  yukinying/chrome-headless-browser\n```\n\nTo run the container with other options, e.g. `--dump-dom`:\n```\ndocker run --init -it --rm --name chrome --shm-size=1024m --cap-add=SYS_ADMIN \\\n  --entrypoint=/usr/bin/google-chrome \\\n  yukinying/chrome-headless-browser \\\n  --headless --disable-gpu --dump-dom https://www.facebook.com\n```\n\nSee the following sections for alternate ways to start the container.\n\n## Why cap-add=SYS_ADMIN is needed\n\nCurrently, there is a user namespace issue in OSX that generates this error:\n```\nFailed to move to new namespace: PID namespaces supported, Network namespace supported,\nbut failed: errno = Operation not permitted\n```\n\nThere are two mitigations, but none of them are ideal as it gives the container some special capabilities:\n\n1. Use a special seccomp profile, as stated in https://twitter.com/jessfraz/status/681934414687801345\n```\ndocker run --init -it --rm --name chrome --shm-size=1024m -p=127.0.0.1:9222:9222 --security-opt seccomp:/path/to/chrome.json \\\n  yukinying/chrome-headless-browser\n```\n\n2. Use CAP_SYS_ADMIN\n```\ndocker run --init -it --rm --name chrome --shm-size=1024m -p=127.0.0.1:9222:9222 --name chrome --cap-add=SYS_ADMIN \\\n  yukinying/chrome-headless-browser\n```\n\n## Getting More Verbose Output\n\nTry adding the following flag: `--enable-logging --v=10000`\n\n## How to run the container with Selenium:\n\nStandalone mode:\n```\ndocker run -it --rm --name chrome --shm-size=1024m --cap-add=SYS_ADMIN \\\n  -p=127.0.0.1:4444:4444 \\\n  yukinying/chrome-headless-browser-selenium\n```\n\nNode mode:\n```\n# First, start your hub.\ndocker run -it --rm --name hub \\\n  -p=127.0.0.1:4444:4444 \\\n  selenium/hub\n\n# Then run your node by registering it to the hub\ndocker run -it --rm --name node-chrome --link hub:hub --cap-add=SYS_ADMIN \\\n  yukinying/chrome-headless-browser-selenium \\\n  -role node -hub http://hub:4444/grid/register \\\n  -nodeConfig /opt/selenium/config.json\n```\n\n## Does the image work with Apple M1?\n\nPlease use \"Chrome Headless Browser Stable\" image. \n\n## Headless Shell\n\nIf you would like to use `headless_shell` instead of `chrome --headless` in Docker, please check out https://github.com/yukinying/chrome-headless-travis-build.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyukinying%2Fchrome-headless-browser-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyukinying%2Fchrome-headless-browser-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyukinying%2Fchrome-headless-browser-docker/lists"}