{"id":13558773,"url":"https://github.com/sameersbn/docker-browser-box","last_synced_at":"2025-04-05T08:05:49.933Z","repository":{"id":21083496,"uuid":"24383299","full_name":"sameersbn/docker-browser-box","owner":"sameersbn","description":"Dockerized google-chome and tor-browser with audio support via pulseaudio","archived":false,"fork":false,"pushed_at":"2018-12-11T03:30:23.000Z","size":86,"stargazers_count":571,"open_issues_count":15,"forks_count":101,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-03-29T07:05:12.985Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sameersbn.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}},"created_at":"2014-09-23T18:04:39.000Z","updated_at":"2025-03-22T19:27:20.000Z","dependencies_parsed_at":"2022-08-27T01:41:16.040Z","dependency_job_id":null,"html_url":"https://github.com/sameersbn/docker-browser-box","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameersbn%2Fdocker-browser-box","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameersbn%2Fdocker-browser-box/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameersbn%2Fdocker-browser-box/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sameersbn%2Fdocker-browser-box/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sameersbn","download_url":"https://codeload.github.com/sameersbn/docker-browser-box/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247305933,"owners_count":20917208,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2024-08-01T12:05:08.763Z","updated_at":"2025-04-05T08:05:49.913Z","avatar_url":"https://github.com/sameersbn.png","language":"Shell","funding_links":[],"categories":["Shell","others"],"sub_categories":[],"readme":"[![Docker Repository on Quay.io](https://quay.io/repository/sameersbn/browser-box/status \"Docker Repository on Quay.io\")](https://quay.io/repository/sameersbn/browser-box)\n\n# sameersbn/browser-box:2018.07.21\n\n- [Introduction](#introduction)\n  - [Contributing](#contributing)\n  - [Issues](#issues)\n- [Getting started](#getting-started)\n  - [Installation](#installation)\n  - [Use Cases](#use-case)\n  - [How it works](#how-it-works)\n- [Maintenance](#maintenance)\n  - [Upgrading](#upgrading)\n  - [Uninstallation](#uninstallation)\n  - [Shell Access](#shell-access)\n- [References](#references)\n\n# Introduction\n\n`Dockerfile` to create a [Docker](https://www.docker.com/) container image consisting of the following web browsers:\n\n - chromium-browser\n - firefox\n - google-chrome\n - tor-browser\n\nThe image uses [X11](http://www.x.org) and [Pulseaudio](http://www.freedesktop.org/wiki/Software/PulseAudio/) unix domain sockets on the host to enable audio/video support in the web browsers. These components are available out of the box on pretty much any modern linux distribution.\n\n![browser](https://cloud.githubusercontent.com/assets/410147/4377777/2ccda3d2-4352-11e4-9314-122e4f58a30c.gif)\n\n## Contributing\n\nIf you find this image useful here's how you can help:\n\n- Send a pull request with your awesome features and bug fixes\n- Help users resolve their [issues](../../issues?q=is%3Aopen+is%3Aissue).\n- Support the development of this image with a [donation](http://www.damagehead.com/donate/)\n\n## Issues\n\nBefore reporting your issue please try updating Docker to the latest version and check if it resolves the issue. Refer to the Docker [installation guide](https://docs.docker.com/installation) for instructions.\n\nSELinux users should try disabling SELinux using the command `setenforce 0` to see if it resolves the issue.\n\nIf the above recommendations do not help then [report your issue](../../issues/new) along with the following information:\n\n- Output of the `docker version` and `docker info` commands\n- The `docker run` command or `docker-compose.yml` used to start the image. Mask out the sensitive bits.\n- Please state if you are using [Boot2Docker](http://www.boot2docker.io), [VirtualBox](https://www.virtualbox.org), etc.\n\n# Getting started\n\n## Installation\n\nAutomated builds of the image are available on [Dockerhub](https://hub.docker.com/r/sameersbn/browser-box) and is the recommended method of installation.\n\n\u003e **Note**: Builds are also available on [Quay.io](https://quay.io/repository/sameersbn/browser-box)\n\n```bash\ndocker pull sameersbn/browser-box:2018.07.21\n```\n\nAlternatively you can build the image yourself.\n\n```bash\ndocker build -t sameersbn/browser-box github.com/sameersbn/docker-browser-box\n```\n\nWith the image locally available, install the wrapper scripts using:\n\n```bash\ndocker run -it --rm \\\n  --volume /usr/local/bin:/target \\\n  --env BROWSER_BOX_REPO=sameersbn \\\n  sameersbn/browser-box:2018.07.21 install\n```\n\nIf you want the settings for chrome and firefox to persist\nafter each time the browser is launched then you will need to add additional environment variable to the install command. In the example below \"username\" needs to get replace with your login user name.\n\n```bash\ndocker run -it --rm \\\n  --volume /usr/local/bin:/target \\\n  --env CHROME_USERDATA=/home/username/.chrome \\\n  --env FIREFOX_USERDATA=/home/username/.mozillia \\\n  --env BROWSER_BOX_REPO=sameersbn \\\n  sameersbn/browser-box:2018.07.21 install\n```\n\n\nThis will install wrapper scripts to launch:\n\n- `chromium-browser`\n- `firefox`\n- `google-chrome, google-chrome-stable`\n- `tor-browser`\n\n\u003e **Note**\n\u003e\n\u003e If the browser being launched is installed on the the host then the host binary is launched instead of starting a Docker container. To force the launch of a browser in a container use the `browser-bundle` script. For example, `browser-bundle firefox` will launch the Firefox browser inside a Docker container regardless of whether it is installed on the host or not.\n\n## Use Cases\n\n- Protect your anonymity on the internet (tor-browser)\n- Access websites your ISP has blocked (tor-browser)\n- Protection from Adobe Flash vulnerabilities\n- Guest access\n\n## How it works\n\nThe wrapper scripts volume mount the X11 and pulseaudio sockets in the launcher container. The X11 socket allows for the user interface display on the host, while the pulseaudio socket allows for the audio output to be rendered on the host.\n\n# Maintenance\n\n## Upgrading\n\nTo upgrade to newer releases:\n\n  1. Download the updated Docker image:\n\n  ```bash\n  docker pull sameersbn/browser-box:2018.07.21\n  ```\n\n  2. Run `install` to make sure the host scripts are updated.\n\n  ```bash\n  docker run -it --rm \\\n    --volume /usr/local/bin:/target \\\n    sameersbn/browser-box:2018.07.21 install\n  ```\n\n## Uninstallation\n\n```bash\ndocker run -it --rm \\\n  --volume /usr/local/bin:/target \\\n  sameersbn/browser-box:2018.07.21 uninstall\n```\n\n## Shell Access\n\nFor debugging and maintenance purposes you may want access the containers shell. If you are using Docker version `1.3.0` or higher you can access a running containers shell by starting `bash` using `docker exec`:\n\n```bash\ndocker exec -it browser-box bash\n```\n\n# References\n\n- http://fabiorehm.com/blog/2014/09/11/running-gui-apps-with-docker/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsameersbn%2Fdocker-browser-box","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsameersbn%2Fdocker-browser-box","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsameersbn%2Fdocker-browser-box/lists"}