/docker-tor-browser

Tor Browser (in a browser)

Primary LanguageDockerfileMIT LicenseMIT

Tor browser

Tor browser running inside of Firefox

About

This image allows running a Tor browser instance on any headless server. The browser can be accessed via either a web interface or directly from any VNC client.

Container is based on baseimage-gui by jlesage

Usage

See the docker-compose here or use this command:

docker run -d -p 5800:5800 domistyle/tor-browser

The web interface will be available on port 5800.

Platform configuration

No special configuration is necessary, however some recommended variables are available:

Variable Description Default Required
DISPLAY_WIDTH Set the width of the virtual screen 1280 No
DISPLAY_HEIGHT Set the height of the virtual screen 768 No
KEEP_APP_RUNNING Automatically restarts the Tor browser if it exits 0 No
TZ Set the time zone for the container - No

** For advanced configuration options please take a look here.**

Browser configuration

You may install the browser with your own configuration. Copy the template configuration to get started. If mozilla.cfg is available then it is used, otherwise no browser changes are made.

cd browser-cfg
cp mozilla.cfg.template mozilla.cfg

** For more information on the available options: http://kb.mozillazine.org/About:config_entries

Volumes

Path Description Required
/app/Browser/TorBrowser/Data/Tor Add a volume for the Tor settings to speedup container startup when the container gets recreated No

Make sure the container user has read & write permission to these folders on the host. More info here.

Ports

Port Description
5800 Provides a web interface to access the Tor browser
5900 Provides direct access to the VNC server

Issues & limitations

  • shm_size might need to be set to 2GB or more if you experience crashes