1- # Home Assistant Community Add-on : Tailscale
1+ # Home Assistant Community App : Tailscale
22
33Tailscale is a zero config VPN, which installs on any device in minutes,
44including your Home Assistant instance.
@@ -9,48 +9,48 @@ manages firewall rules for you, and works from anywhere you are.
99
1010## Prerequisites
1111
12- In order to use this add-on , you'll need a Tailscale account.
12+ In order to use this app , you'll need a Tailscale account.
1313
1414It is free to use for personal & hobby projects, up to 100 clients/devices on a
1515single user account. Sign up using your Google, Microsoft or GitHub account at
1616the following URL:
1717
1818< https://login.tailscale.com/start >
1919
20- You can also create an account during the add-on installation processes,
20+ You can also create an account during the app installation processes,
2121however, it is nice to know where you need to go later on.
2222
2323## Installation
2424
25- 1 . Click the Home Assistant My button below to open the add-on on your Home
25+ 1 . Click the Home Assistant My button below to open the app on your Home
2626 Assistant instance.
2727
28- [ ![ Open this add-on in your Home Assistant instance.] [ addon-badge ]] [ addon ]
28+ [ ![ Open this app in your Home Assistant instance.] [ addon-badge ]] [ addon ]
2929
30- 1 . Click the "Install" button to install the add-on .
31- 1 . Start the "Tailscale" add-on .
32- 1 . Check the logs of the "Tailscale" add-on to see if everything went well.
33- 1 . Open the Web UI of the "Tailscale" add-on to complete authentication and
30+ 1 . Click the "Install" button to install the app .
31+ 1 . Start the "Tailscale" app .
32+ 1 . Check the logs of the "Tailscale" app to see if everything went well.
33+ 1 . Open the Web UI of the "Tailscale" app to complete authentication and
3434 couple your Home Assistant instance with your Tailscale account.
3535 ** Note:** Some browsers don't work with this step. It is recommended to
3636 complete this step on a desktop or laptop computer using the Chrome browser.
37- 1 . Check the logs of the "Tailscale" add-on again, to see if everything went
37+ 1 . Check the logs of the "Tailscale" app again, to see if everything went
3838 well.
39391 . Done!
4040
4141## Configuration
4242
43- This add-on has almost no additional configuration options for the
44- add-on itself.
43+ This app has almost no additional configuration options for the
44+ app itself.
4545
4646However, when logging in to Tailscale, you can configure your Tailscale
4747network right from their interface.
4848
4949< https://login.tailscale.com/ >
5050
51- The add-on exposes "Exit Node" capabilities that you can enable from your
51+ The app exposes "Exit Node" capabilities that you can enable from your
5252Tailscale account. Additionally, if the Supervisor managed your network (which
53- is the default), the add-on will also advertise routes to your subnets on all
53+ is the default), the app will also advertise routes to your subnets on all
5454supported interfaces to Tailscale.
5555
5656Consider disabling key expiry to avoid losing connection to your Home Assistant
@@ -82,7 +82,7 @@ userspace_networking: true
8282> Some of the configuration options are also available on Tailscale's web
8383> interface through the Web UI, but they are made read only there. You can't
8484> change them through the Web UI, because all the changes made there would be
85- > lost when the add-on is restarted.
85+ > lost when the app is restarted.
8686
8787### Option: ` accept_dns`
8888
@@ -92,7 +92,7 @@ disable, you can do so using this option.
9292When not set, this option is enabled by default.
9393
9494MagicDNS may cause issues if you run things like Pi-hole or AdGuard Home
95- on the same machine as this add-on . In such cases disabling `accept_dns`
95+ on the same machine as this app . In such cases disabling `accept_dns`
9696will help. You can still leverage MagicDNS on other devices on your network,
9797by adding `100.100.100.100` as a DNS server in your Pi-hole or AdGuard Home.
9898
@@ -149,7 +149,7 @@ If you want to disable this option, specify an empty list in the configuration
149149
150150More information: [Subnet routers][tailscale_info_subnets]
151151
152- When not set, the add-on by default will advertise routes to your subnets on all
152+ When not set, the app by default will advertise routes to your subnets on all
153153supported interfaces.
154154
155155### Option: `exit_node`
@@ -175,12 +175,12 @@ node is specified. This is required by the Home Assistant environment.
175175
176176### Option: `log_level`
177177
178- Optionally enable tailscaled debug messages in the add-on 's log. Turn it on only
178+ Optionally enable tailscaled debug messages in the app 's log. Turn it on only
179179in case you are troubleshooting, because Tailscale's daemon is quite chatty. If
180- `log_level` is set to `info` or less severe level, the add-on also opts out of
180+ `log_level` is set to `info` or less severe level, the app also opts out of
181181client log upload to log.tailscale.io.
182182
183- The `log_level` option controls the level of log output by the addon and can
183+ The `log_level` option controls the level of log output by the app and can
184184be changed to be more or less verbose, which might be useful when you are
185185dealing with an unknown issue. Possible values are:
186186
@@ -190,7 +190,7 @@ dealing with an unknown issue. Possible values are:
190190- `notice`: Normal but significant events.
191191- `warning`: Exceptional occurrences that are not errors.
192192- `error`: Runtime errors that do not require immediate action.
193- - `fatal`: Something went terribly wrong. Add-on becomes unusable.
193+ - `fatal`: Something went terribly wrong. App becomes unusable.
194194
195195Please note that each level automatically includes log messages from a
196196more severe level, e.g., `debug` also shows `info` messages. By default,
@@ -237,7 +237,7 @@ More information: [Enabling HTTPS][tailscale_info_https],
2372371. Configure Home Assistant to be accessible through an HTTP connection (this is
238238 the default). See [HTTP integration documentation][http_integration] for more
239239 information. If you still want to use another HTTPS connection to access Home
240- Assistant, please use a reverse proxy add-on .
240+ Assistant, please use a reverse proxy app .
241241
2422421. Home Assistant, by default, blocks requests from reverse proxies, like the
243243 Tailscale Serve. To enable it, add the following lines to your
@@ -264,7 +264,7 @@ More information: [Enabling HTTPS][tailscale_info_https],
264264 [Tailnet policy file requirement][tailscale_info_funnel_policy_requirement]
265265 for more information.
266266
267- 1. Restart the add-on .
267+ 1. Restart the app .
268268
269269**Note**: After initial setup, it can take up to 10 minutes for the domain to
270270be publicly available.
@@ -297,7 +297,7 @@ When not set, this option is enabled by default.
297297To support advanced [Site-to-site networking][tailscale_info_site_to_site] (e.g.
298298to traverse multiple networks), you can disable this functionality, and follow
299299steps in the [Site-to-site networking][tailscale_info_site_to_site] guide (Note:
300- The add-on already handles " IP address forwarding" and "Clamp the MSS to the
300+ The app already handles " IP address forwarding" and "Clamp the MSS to the
301301MTU" for you).
302302
303303**Note:** Only disable this option if you fully understand the implications.
@@ -322,7 +322,7 @@ More information: [Tags][tailscale_info_tags]
322322
323323# ## Option: `taildrop`
324324
325- This add-on supports [Tailscale's Taildrop][tailscale_info_taildrop] feature,
325+ This app supports [Tailscale's Taildrop][tailscale_info_taildrop] feature,
326326which allows you to send files to your Home Assistant instance from other
327327Tailscale devices.
328328
@@ -332,7 +332,7 @@ Received files are stored in the `/share/taildrop` directory.
332332
333333# ## Option: `userspace_networking`
334334
335- The add-on uses [userspace networking mode][tailscale_info_userspace_networking]
335+ The app uses [userspace networking mode][tailscale_info_userspace_networking]
336336to make your Home Assistant instance (and optionally the local subnets)
337337accessible within your tailnet.
338338
@@ -346,15 +346,15 @@ Assistant's DNS options also.
346346
347347If you want to access other clients on your tailnet even from your local subnet,
348348follow steps in the [Site-to-site networking][tailscale_info_site_to_site] guide
349- (Note : The add-on already handles "IP address forwarding" and "Clamp the MSS to
349+ (Note : The app already handles "IP address forwarding" and "Clamp the MSS to
350350the MTU" for you).
351351
352352**Note:** In case your local subnets collide with subnet routes within your
353353tailnet, your local network access has priority, and these addresses won't be
354354routed toward your tailnet. This will prevent your Home Assistant instance from
355355losing network connection. This also means that using the same subnet on
356356multiple nodes for load balancing and failover is impossible with the current
357- add-on behavior.
357+ app behavior.
358358
359359**Note:** The `userspace_networking` option can remain enabled if you only need
360360one-way access from tailnet clients to your local subnet, without requiring
@@ -397,7 +397,7 @@ Got questions?
397397
398398You have several options to get them answered :
399399
400- - The [Home Assistant Community Add-ons Discord chat server][discord] for add-on
400+ - The [Home Assistant Community Apps Discord chat server][discord] for app
401401 support and feature requests.
402402- The [Home Assistant Discord chat server][discord-ha] for general Home
403403 Assistant discussions and questions.
@@ -417,7 +417,7 @@ check [the contributor's page][contributors].
417417
418418MIT License
419419
420- Copyright (c) 2021-2025 Franck Nijhof
420+ Copyright (c) 2021-2026 Franck Nijhof
421421
422422Permission is hereby granted, free of charge, to any person obtaining a copy
423423of this software and associated documentation files (the "Software"), to deal
@@ -439,16 +439,16 @@ SOFTWARE.
439439
440440[addon-badge] : https://my.home-assistant.io/badges/supervisor_addon.svg
441441[addon] : https://my.home-assistant.io/redirect/supervisor_addon/?addon=a0d7b954_tailscale&repository_url=https%3A%2F%2Fgithub.com%2Fhassio-addons%2Frepository
442- [contributors] : https://github.com/hassio-addons/addon -tailscale/graphs/contributors
442+ [contributors] : https://github.com/hassio-addons/app -tailscale/graphs/contributors
443443[discord-ha] : https://discord.gg/c5DvZ4e
444444[discord] : https://discord.me/hassioaddons
445445[forum] : https://community.home-assistant.io/?u=frenck
446446[frenck] : https://github.com/frenck
447447[headscale] : https://github.com/juanfont/headscale
448448[http_integration] : https://www.home-assistant.io/integrations/http/
449- [issue] : https://github.com/hassio-addons/addon -tailscale/issues
449+ [issue] : https://github.com/hassio-addons/app -tailscale/issues
450450[reddit] : https://reddit.com/r/homeassistant
451- [releases] : https://github.com/hassio-addons/addon -tailscale/releases
451+ [releases] : https://github.com/hassio-addons/app -tailscale/releases
452452[semver] : https://semver.org/spec/v2.0.0.html
453453[tailscale_acls] : https://login.tailscale.com/admin/acls
454454[tailscale_dns] : https://login.tailscale.com/admin/dns
0 commit comments