lncm/tor repository overview

⁠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

• latest
• 0.4.7.9
• 0.4.7.8⁠
• 0.4.7.7⁠
• 0.4.6.8
• 0.4.5.11
• 0.4.7.1-alpha⁠
• 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.7.9

Would Release 0.4.7.9 of tor.

As a maintainer, you should also update the documentation too.

⁠Environment Variables

• DOCKER_HUB_USER - the username for docker hub
• DOCKER_USERNAME - The username for dockerhub.
• DOCKER_PASSWORD - The password for dockerhub
• DOCKER_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.com
• GITHUB_REPOSITORY - The repository pathname (used for the push to githubs package registry)

⁠Running

⁠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.7.9

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.7.8 \
            --hash-password passwordtogenerate