I maintain this and other Home Assistant add-ons in my free time: keeping up with upstream changes, HA changes, and testing on real hardware takes a lot of time (and some money). I use around 5-10 of my >110 addons so regularly I install test machines (and purchase some test services such as vpn) that I don't use myself to troubleshoot and improve the addons

If this add-on saves you time or makes your setup easier, I would be very grateful for your support!

Addon informations

Thanks to everyone having starred my repo! To star it click on the image below, then it will be on top right. Thanks!

About

Extended version of the Tor addon from Home Assistant Community repository by supporting multiples bridges protocols WebTunnel, Snowflake and OBFS.

Installation

The installation of this add-on is pretty straightforward and not different in comparison to installing any other add-on.

Add my add-ons repository to your home assistant instance (in supervisor addons store at top right, or click button below if you have configured my HA)
Install this add-on.
Click the Save button to store your configuration.
Set the add-on options to your preferences
Start the add-on.
Check the logs of the add-on to see if everything went well.
Open the webUI and adapt the software options

Configuration

Use the add-on env_vars option to pass extra environment variables (uppercase or lowercase names). See https://github.com/alexbelgium/hassio-addons/wiki/Add-Environment-variables-to-your-Addon-2 for details.

Configurations can be done through the app webUI, except for the following options.

Options

Option	Type	Default	Description
`hidden_services`	bool	`true`	Enable Tor hidden services
`http_tunnel`	bool	`false`	Enable HTTP tunnel on port 9080
`socks`	bool	`false`	Enable SOCKS proxy
`stealth`	bool	`false`	Enable stealth mode
`bridges`	list	`[]`	List of bridge configurations
`client_names`	list	`[]`	Client names for stealth authentication
`ports`	list	`["8123", "8123:80"]`	Ports to expose via Tor
`log_level`	list		Log level (trace/debug/info/notice/warning/error/fatal)

You should follow the initial guide for configuring base addon options. Here are the extra options specific to this extended version:

Option: `http_tunnel`

Setting this option to true opens port 9080 to listen for connections from HTTP-speaking applications. Enabling this feature allows you to use other applications on your network to use the Tor network via http proxy.

Option: `bridges`

Ensure the option value is clear to avoid unintended use of transport plugins and bridges.

Bridges are Tor relays that help you circumvent censorship. Access to bridges is provided by supported transport plugins:

OBFS

Because bridge addresses are not public, you will need to request them yourself. You have a few options:

Visit Tor project and follow the instructions, or
Email bridges@torproject.org from a Gmail, or Riseup email address
Send a message to @GetBridgesBot on Telegram. Tap on 'Start' or write /start or /bridges in the chat.

For example:

bridges:
  - >-
    obfs4 123.45.67.89:443 EFC6A00EE6272355C023862378AC77F935F091E4
    cert=KkdWiWlfetJG9SFrzX8g1teBbgxtsc0zPiN5VLxqNNH+iudVW48CoH/XVXPQntbivXIqZA
    iat-mode=0

Webtunnel

Visit Tor project and follow the instructions

For example:

bridges:
  - >-
    webtunnel 192.0.2.3:1
    DEADBEEFDEADBEEFDEADBEEFDEADBEEFDEADBEEF
    url=https://akbwadp9lc5fyyz0cj4d76z643pxgbfh6oyc-167-71-71-157.sslip.io/5m9yq0j4ghkz0fz7qmuw58cvbjon0ebnrsp0
    ver=0.0.1

Snowflake

What is snowflake, example:

bridges:
  - >-
    snowflake 192.0.2.3:80 2B280B23E1107BB62ABFC40DDCC8824814F80A72
    fingerprint=2B280B23E1107BB62ABFC40DDCC8824814F80A72
    url=https://snowflake-broker.torproject.net/
    ampcache=https://cdn.ampproject.org/
    front=www.google.com
    ice=stun:stun.l.google.com:19302,stun:stun.antisip.com:3478,stun:stun.bluesip.net:3478,stun:stun.dus.net:3478,stun:stun.epygi.com:3478,stun:stun.sonetel.com:3478,stun:stun.uls.co.za:3478,stun:stun.voipgate.com:3478,stun:stun.voys.nl:3478
    utls-imitate=hellorandomizedalpn

Support

If you have in issue with your installation, please be sure to checkout github.

README.md

⚠ Open Request : ✨ [REQUEST] Tandoor - Connectors (opened 2025-10-08) by @blowk

⚠ Open Issue : 🐛 [LINKWARDEN] Never use STORAGE_FOLDER (opened 2025-10-11) by @guimex22

Hass.io Add-ons: Tor with bridges