qix- / docker-tor

Tor built and verified by github and packed in a container

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 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)
• MAINTAINER_USER - This is for utilizing the github container registry
• MAINTAINER_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