Configuration
Others
Tor browser running inside of Firefox
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
Both amd64 and arm64 container runtimes are supported, but only the amd64 image uses an official build of the Tor Browser. The arm64 image uses an unofficial build via tor-browser-ports because the Tor Project does not have an official arm build of the Tor Browser. Both the official and unofficial builds are signed, and the signatures are verified when building this container.
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.
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.**
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
It is not recommended to add persistent volumes to your Tor Browser. We do not support any issues that arise from persistent volumes.
version: '3.9'
services:
tor:
image: domistyle/tor-browser
container_name: tor
restart: unless-stopped
ports:
- 5800:5800
- 5900:5900
environment:
DISPLAY_WIDTH: 1920
DISPLAY_HEIGHT: 1080
KEEP_APP_RUNNING: 1
TZ: Europe/Vienna
To install tor browser using docker compose, copy and paste the command in your terminal
docker compose up
To stop the docker container do
docker stop tor
To start the container again, put the following command below and paste it in your terminal
docker start tor
To remove the container you can do
docker compose down
or you can do this
docker rm tor
First update all your packages by doing
sudo apt update
After you update all your packages then it is time to install docker.io by doing
sudo apt install -y docker.io
To add systemctl to docker do this
sudo systemctl enable docker --now
To verify that you docker put the following command below
docker
To use docker without doing sudo every time do this
sudo usermod -aG docker $USER
Port | Description |
---|---|
5800 |
Provides a web interface to access the Tor browser |
5900 |
Provides direct access to the NoVNC server |
- shm_size might need to be set to 2GB or more if you experience crashes