{"id":19866143,"url":"https://github.com/ogarcia/docker-tor","last_synced_at":"2026-01-18T11:36:23.099Z","repository":{"id":140080129,"uuid":"71638056","full_name":"ogarcia/docker-tor","owner":"ogarcia","description":"[MIRROR] Small docker of Tor client","archived":false,"fork":false,"pushed_at":"2025-01-07T08:45:48.000Z","size":32,"stargazers_count":6,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-07T09:38:16.762Z","etag":null,"topics":["docker","docker-image","privacy","tor"],"latest_commit_sha":null,"homepage":"https://gitlab.com/connectical/container/tor","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ogarcia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-10-22T12:37:32.000Z","updated_at":"2025-01-07T08:45:51.000Z","dependencies_parsed_at":"2024-11-12T15:32:11.530Z","dependency_job_id":"d1291cf1-1b04-4de8-941e-54b98c45fd9b","html_url":"https://github.com/ogarcia/docker-tor","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogarcia%2Fdocker-tor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogarcia%2Fdocker-tor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogarcia%2Fdocker-tor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ogarcia%2Fdocker-tor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ogarcia","download_url":"https://codeload.github.com/ogarcia/docker-tor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251993002,"owners_count":21677022,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-image","privacy","tor"],"created_at":"2024-11-12T15:25:06.259Z","updated_at":"2026-01-17T07:07:26.559Z","avatar_url":"https://github.com/ogarcia.png","language":"Makefile","funding_links":[],"categories":["Makefile"],"sub_categories":[],"readme":"# Small container of Tor client\n\n[![forthebadge](https://forthebadge.com/images/badges/made-with-crayons.svg)](https://forthebadge.com)\n[![forthebadge](https://forthebadge.com/images/badges/built-with-love.svg)](https://forthebadge.com)\n[![forthebadge](https://forthebadge.com/images/badges/powered-by-responsibility.svg)](https://forthebadge.com)\n\n(c) 2015-2025 [Connectical] Óscar García Amor\n\nRedistribution, modifications and pull requests are welcomed under the terms\nof GPLv3 license.\n\n[Tor][to] is free software and an open network that helps you defend against\ntraffic analysis, a form of network surveillance that threatens personal\nfreedom and privacy, confidential business activities and relationships, and\nstate security.\n\nThis container packages **Tor** under [Alpine Linux][al], a lightweight\nLinux distribution.\n\nVisit [Quay][qu] or [GitLab][gl] to see all available tags.\n\n[to]: https://www.torproject.org/\n[al]: https://alpinelinux.org/\n[qu]: https://quay.io/repository/connectical/tor\n[gl]: https://gitlab.com/connectical/container/tor/container_registry\n\n## Run\n\nTo run this container, simply exec.\n\n```sh\nalias docker=\"podman\" # If you are using podman\ndocker run -d \\\n  --name=tor \\\n  -v /srv/tor/cfg:/etc/tor \\\n  -v /srv/tor/data:/var/lib/tor \\\n  registry.gitlab.com/connectical/container/tor\n```\n\nThis start `tor` client and store config in `/srv/tor/cfg` and data in\n`/srv/tor/data` persistent volumes.\n\nTake note that, by default, `tor` store its data into `/var/lib/tor` as\na home directory, you need to add the following line in `torrc` config file\nto set as data directory and set owner of `/srv/tor/data` to UID and GID 100.\n\n```sh\nmkdir -p /srv/tor/cfg /srv/tor/data\necho \"DataDirectory /var/lib/tor\" \u003e /srv/tor/cfg/torrc\nchown 100:100 /srv/tor/data\n```\n\n## Sample configs\n\n### Tor SOCKS Proxy\n\nTo use as Tor proxy set `/srv/tor/cfg/torrc` as following.\n\n```\nSOCKSPort 0.0.0.0:9050\nDataDirectory /var/lib/tor\n```\n\nAnd run it.\n\n```sh\nalias docker=\"podman\" # If you are using podman\ndocker run -d \\\n  --name=tor \\\n  -p 127.0.0.1:9050:9050 \\\n  -v /srv/tor/cfg:/etc/tor \\\n  -v /srv/tor/data:/var/lib/tor \\\n  registry.gitlab.com/connectical/container/tor\n```\n\nNext, open your browser, set `127.0.0.1:9050` as socks proxy and go to\nhttps://check.torproject.org/ to check if you are using the Tor network.\n\n### Tor Hidden Service\n\nTo use as service server.\n\n```\nSOCKSPort 0\nDataDirectory /var/lib/tor\nHiddenServiceDir /var/lib/tor/github.com/\nHiddenServicePort 22  192.30.253.112:22\nHiddenServicePort 80  192.30.253.112:80\nHiddenServicePort 443 192.30.253.112:443\n```\n\nAnd run it.\n\n```sh\nalias docker=\"podman\" # If you are using podman\ndocker run -d \\\n  --name=tor \\\n  -v /srv/tor/cfg:/etc/tor \\\n  -v /srv/tor/data:/var/lib/tor \\\n  registry.gitlab.com/connectical/container/tor\n```\n\n### Other\n\nYou can use `tor` as bridge, enter relay or exit relay, see [Tor Docs][6]\nfor more info.\n\n[6]: https://www.torproject.org/docs/documentation.html.en\n\n## Shell run\n\nIf you can run a shell instead `tor` command, simply do.\n\n```sh\nalias docker=\"podman\" # If you are using podman\ndocker run -t -i --rm \\\n  --name=tor \\\n  -v /srv/tor/cfg:/etc/tor \\\n  -v /srv/tor/data:/var/lib/tor \\\n  --entrypoint=/bin/sh \\\n  registry.gitlab.com/connectical/container/tor\n```\n\nPlease note that the `--rm` modifier destroy the container after shell exit.\n\n## See Tor sample config\n\nIf you need to see a documented config file of `tor`, you can open the\n`torrc.sample` with following command.\n\n```sh\nalias docker=\"podman\" # If you are using podman\ndocker run -t -i --rm --entrypoint=/usr/bin/less \\\n  registry.gitlab.com/connectical/container/tor /etc/tor/torrc.sample\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fogarcia%2Fdocker-tor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fogarcia%2Fdocker-tor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fogarcia%2Fdocker-tor/lists"}