You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
136 lines
4.2 KiB
Markdown
136 lines
4.2 KiB
Markdown
# sameersbn/browser-box:latest
|
|
|
|
- [Introduction](#introduction)
|
|
- [Contributing](#contributing)
|
|
- [Issues](#issues)
|
|
- [Getting started](#getting-started)
|
|
- [Installation](#installation)
|
|
- [Use Cases](#use-case)
|
|
- [How it works](#how-it-works)
|
|
- [Maintenance](#maintenance)
|
|
- [Upgrading](#upgrading)
|
|
- [Uninstallation](#uninstallation)
|
|
- [Shell Access](#shell-access)
|
|
- [References](#references)
|
|
|
|
# Introduction
|
|
|
|
`Dockerfile` to create a [Docker](https://www.docker.com/) container image with consisting of the following web browsers:
|
|
|
|
- chromium-browser
|
|
- firefox
|
|
- google-chrome
|
|
- tor-browser
|
|
|
|
The 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.
|
|
|
|
![browser](https://cloud.githubusercontent.com/assets/410147/4377777/2ccda3d2-4352-11e4-9314-122e4f58a30c.gif)
|
|
|
|
## Contributing
|
|
|
|
If you find this image useful here's how you can help:
|
|
|
|
- Send a pull request with your awesome features and bug fixes
|
|
- Help users resolve their [issues](../../issues?q=is%3Aopen+is%3Aissue).
|
|
- Support the development of this image with a [donation](http://www.damagehead.com/donate/)
|
|
|
|
## Issues
|
|
|
|
Before 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.
|
|
|
|
SELinux users should try disabling SELinux using the command `setenforce 0` to see if it resolves the issue.
|
|
|
|
If the above recommendations do not help then [report your issue](../../issues/new) along with the following information:
|
|
|
|
- Output of the `docker version` and `docker info` commands
|
|
- The `docker run` command or `docker-compose.yml` used to start the image. Mask out the sensitive bits.
|
|
- Please state if you are using [Boot2Docker](http://www.boot2docker.io), [VirtualBox](https://www.virtualbox.org), etc.
|
|
|
|
# Getting started
|
|
|
|
## Installation
|
|
|
|
This image is available as a [trusted build](//hub.docker.com/r/sameersbn/browser-box) on the [Docker hub](//hub.docker.com) and is the recommended method of installation.
|
|
|
|
```bash
|
|
docker pull sameersbn/browser-box:latest
|
|
```
|
|
|
|
Alternatively you can build the image yourself.
|
|
|
|
```bash
|
|
git clone https://github.com/sameersbn/docker-browser-box.git
|
|
cd docker-browser-box
|
|
docker build --tag $USER/browser-box .
|
|
```
|
|
|
|
With the image locally available, install the wrapper scripts using:
|
|
|
|
```bash
|
|
docker run -it --rm \
|
|
--volume /usr/local/bin:/target \
|
|
sameersbn/browser-box:latest install
|
|
```
|
|
|
|
This will install wrapper scripts to launch:
|
|
|
|
- `chromium-browser`
|
|
- `firefox`
|
|
- `google-chrome, google-chrome-stable`
|
|
- `tor-browser`
|
|
|
|
> **Note**
|
|
>
|
|
> If the application being launched is already installed on the host, then the host command is executed and the docker image is not started.
|
|
|
|
## Use Cases
|
|
|
|
- Protect your anonymity on the internet (tor-browser)
|
|
- Access websites your ISP has blocked (tor-browser)
|
|
- Protection from Adobe Flash vulnerabilities
|
|
- Guest access
|
|
|
|
## How it works
|
|
|
|
The 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.
|
|
|
|
# Maintenance
|
|
|
|
## Upgrading
|
|
|
|
To upgrade to newer releases:
|
|
|
|
1. Download the updated Docker image:
|
|
|
|
```bash
|
|
docker pull sameersbn/browser-box:latest
|
|
```
|
|
|
|
2. Run `install` to make sure host scripts are updated.
|
|
|
|
```bash
|
|
docker run -it --rm \
|
|
--volume /usr/local/bin:/target \
|
|
sameersbn/browser-box:latest install
|
|
```
|
|
|
|
## Uninstallation
|
|
|
|
```bash
|
|
docker run -it --rm \
|
|
--volume /usr/local/bin:/target \
|
|
sameersbn/browser-box:latest uninstall
|
|
```
|
|
|
|
## Shell Access
|
|
|
|
For 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`:
|
|
|
|
```bash
|
|
docker exec -it browser-box bash
|
|
```
|
|
|
|
# References
|
|
|
|
- http://fabiorehm.com/blog/2014/09/11/running-gui-apps-with-docker/
|