Skip to content

TOR built and verified by github and packed in a container

License

Notifications You must be signed in to change notification settings

bitcoin-brasil/docker-tor

 
 

Repository files navigation

TOR as a Docker container

Build on push Build on tag deploy Version Docker Pulls Count

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

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.5.7

Would Release 0.4.5.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.5.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

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

About

TOR built and verified by github and packed in a container

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Dockerfile 68.2%
  • Shell 31.8%