Tor as a Docker container
Tor service as a docker container, supporting multiple platforms/architectures (armv6, armv7, arm64, amd64) the LNCM way (inclusive)
Usage instructions
Tags
NOTE: For an always up-to-date list see: https://hub.docker.com/r/lncm/tor/tags
latest
0.4.6.8
0.4.5.11
0.4.7.1-alpha
0.4.6.6
0.4.6.7
0.4.4.8
0.4.5.7
0.4.5.6
0.4.4.7
0.4.5.5-rc
0.4.5.3-rc
0.4.4.5
0.4.4.6
0.4.4.4-rc
0.4.3.6
Maintainer release notes
The github action takes in the current tag from upstream and then fetches, verifies and compiles this.
To grab a new version simply just tag a new version
Example:
git tag -s 0.4.6.7
Would Release 0.4.6.7
of tor.
As a maintainer, you should also update the documentation too.
Environment Variables
Note In order to trigger builds This repository uses the following environment variables:
DOCKER_HUB_USER
- the username for docker hubDOCKER_USERNAME
- The username for dockerhub.DOCKER_PASSWORD
- The password for dockerhubDOCKER_TOKEN
- the token for docker hub which can push to this projecta (not used currently)GITHUB_TOKEN
- The token of the current user (this is added automatically)GITHUB_ACTOR
- The user to login to docker.pkg.github.comGITHUB_REPOSITORY
- The repository pathname (used for the push to githubs package registry)MAINTAINER_USER
- This is for utilizing the github container registryMAINTAINER_TOKEN
- This is for utilizing the github container registry
Running
this assumes
0.4.6.7
version. But you can substitute this for others
Command Line
To run this from the command line you would need to create an example config file or use the cut down config file in this repo.
Then you would need to run:
docker run --rm -d \
--network host \
--name tor \
-v $PWD/data:/etc/tor \
-v $PWD/data:/var/lib/tor \
-v $PWD/run:/var/run/tor \
lncm/tor:0.4.6.7
This assumes you have a directory called data
and a directory called run
in the current $PWD
. And the config file torrc
should live in data.
Docker-compose
For your convenience, we have a docker-compose file available for you to use too.
By default this uses host networking and requires data
and run
folders to be created and with a valid torrc file
Generating Tor Passwords
docker run --rm \
--name tor \
lncm/tor:0.4.6.7 \
--hash-password passwordtogenerate