Skip to content
View in the app

A better way to browse. Learn more.

Unraid

A full-screen app on your home screen with push notifications, badges and more.

To install this app on iOS and iPadOS
  1. Tap the Share icon in Safari
  2. Scroll the menu and tap Add to Home Screen.
  3. Tap Add in the top-right corner.
To install this app on Android
  1. Tap the 3-dot menu (⋮) in the top-right corner of the browser.
  2. Tap Add to Home screen or Install app.
  3. Confirm by tapping Install.
Message added by EDACerton,

When requesting support, please include a Tailscale diag package with your request:

 

https://edac.dev/unraid/plugin-diagnostics/usage/

[Plugin] Tailscale

Featured Replies

1 hour ago, gamerkonks said:

I'm having trouble enabling the Tailscale SSH server on my unraid server.
I go to myUnraidUrl/Settings/Tailscale, click Viewing and then Sign in. Then after signing in on the new tab, I click Tailscale SSH server. Then I click "Run Tailscale SSH server", to toggle it on, but it immediately toggles off and I get an error message in the bottom right which reads "Failed to update node preference".

I'm running unraid 7.0.0 and Tailscale 1.80.0-t4f4686503-gccb3ce01b

Does anyone know what's causing this?

 

 

Running the command in terminal got it enabled.

tailscale up --ssh

 

  • Replies 1.7k
  • Views 377.4k
  • Created
  • Last Reply

Top Posters In This Topic

Most Popular Posts

  • EDACerton
    EDACerton

    This topic is not for support of the Tailscale docker integration. Please make a post in the appropriate OS support forum for issues related to the docker integration. Common Issues I

  • 2024.08.28   This update contains an important alert for Unraid Connect users. We recently determined that the Flash Backup feature of Unraid Connect would back up the Tailscale state file.

  • EDACerton
    EDACerton

    2023.05.25b Update Tailscale to 1.42.0 Add Tailscale web interface to Settings page Add page for Tailscale / plugin logs Switch Taildrop implementation to use native Unrai

Posted Images

is there a helpful guide or resource for this plugin? I want to be able to set it up  to just point at two separate containers. I can't seem to find a walkthrough for just  the plugin.

4 hours ago, danheinz said:

is there a helpful guide or resource for this plugin? I want to be able to set it up  to just point at two separate containers. I can't seem to find a walkthrough for just  the plugin.

 

 

 

On 2/25/2025 at 10:05 AM, Haris2887 said:

Hi All,

I am convinced that this plugin is broken under Unraid 6.12.13.

When starting tailscale, the process uses random wireguard ports even when the port is specified under the GUI.

As the result i can never get direct connections as the firewall mapping don't match. I am not intrested in UPNP that induces other security issues in the environment.

 

I suspect the issue is the running command :
 

/usr/local/sbin/tailscaled -statedir /boot/config/plugins/tailscale/state -tun tailscale1 -port 41641

Should be with a "--port" at the end.

I have tried completely uninstalling the plugin and reinstalling. Cleaning up manually by deleting all tailscale files etc...
image.thumb.png.61c320f30582d708e7c29ea88c9cf541.png

image.png.fa7de5a5f2d24468feacedfc1b4135ab.png

Issue resolved by uninstalling plugin completely.

Then changing this setting in the WEB UI admin console. THe Reinstalling Plugin.

image.thumb.png.a20fd3a1117477ef10fca15d941dc7ee.pngimage.thumb.png.a20fd3a1117477ef10fca15d941dc7ee.png

 

Since upgrading to 7.0.0, I have been unable to use Tailscale. The Settings > Tailscale page just shows the error below. Restarting Tailscale and server have no effect. I've also tried erasing the Tailscale settings.

 

Is there something else I can try?

 

Error:

TypeError Object ( [message:protected] => Tailscale\Info::getTailscaleLockEnabled(): Return value must be of type bool, null returned

NAS-tailscale-diag-20250226-101946.zip

  • Author
47 minutes ago, abitwilder said:

Since upgrading to 7.0.0, I have been unable to use Tailscale. The Settings > Tailscale page just shows the error below. Restarting Tailscale and server have no effect. I've also tried erasing the Tailscale settings.

 

Is there something else I can try?

 

Error:

TypeError Object ( [message:protected] => Tailscale\Info::getTailscaleLockEnabled(): Return value must be of type bool, null returned

NAS-tailscale-diag-20250226-101946.zip 180.19 kB · 1 download

It looks like tailscaled isn't starting on your system... what happens if you run this from the console?

 

/usr/local/sbin/tailscaled -statedir /boot/config/plugins/tailscale/state -tun tailscale1

 

13 minutes ago, EDACerton said:

It looks like tailscaled isn't starting on your system... what happens if you run this from the console?

 

/usr/local/sbin/tailscaled -statedir /boot/config/plugins/tailscale/state -tun tailscale1

 

 

Welp. That result was not good...

 

Segmentation fault

 

I've had occasional memory issues before, so that's likely the issue. I backed up and went ahead and updated to 7.0.1, hoping that it was just an error with my 7.0.0 update. With 7.0.1 installed, Tailscale is working properly again. Thanks for your help pointing me in the right direction!

So I finally updated to unraid 7.0.1 and enabled exit node on my VPN containers, but they do not show up as exit nodes on any of my devices. Do I need to run the preview version of the tailscale plugin for this to work? I'm running 1.78.1-t8903926f7-gc4163954e right now.

Edit: I see the tailscale version on the containers are 1.80.2 but the plugin is 1.78.1

Edited by strike

Hi!

 

I'm unsure what my issues is with my setup. I had it fine originally but accidentally ran a tailscale up command I meant for a different device on my unraid server so I reset the plugin. 

 

I think I originally ran with this command:

tailscale up --accept-dns=false --advertise-exit-node --advertise-routes=10.0.1.0/24

 

However, after accepting the routes, it doesn't work on my other devices. I had to split the subnet for it to finally work from my other devices:

tailscale up --accept-dns=false --advertise-exit-node --advertise-routes=10.0.1.0/25,10.0.1.128/25

 

 

Any idea why this is? It is the same case for my other subnets as well.

On 3/3/2025 at 6:46 PM, strike said:

So I finally updated to unraid 7.0.1 and enabled exit node on my VPN containers, but they do not show up as exit nodes on any of my devices. Do I need to run the preview version of the tailscale plugin for this to work? I'm running 1.78.1-t8903926f7-gc4163954e right now.

Edit: I see the tailscale version on the containers are 1.80.2 but the plugin is 1.78.1

So I figured this out. Installed the preview plugin an then I got a warning that I had to approve the exit nodes. After I did that it works. Now I have one more question, is there a way to use the docker containers DNS? I do not want to use tailscale DNS as it's super slow for me. I want to use the DNS server of my VPN container on my devices so I don't get DNS leaks.

hi,

i have some trouble with tailscale or more with bringing it up....

i have tailscail plugin installed and via gui my home network advertised, thats looking fine in tailscale admin.

i have a smartphone outside of my homenet connected to tailscaile and i would expect to reach ip addresses in the advertised network.

i had this stuff to keep in mind ip addresses and so on and have a private dns server that i want to use for resolving some domains, its working fine in my homelab but it looks that i cant reach the homenet via tailscale.... did i miss something?

 

What i have not done is any commands in console, i expect that it is fine if i do it via unraid gui

 

This is what i get in Logs.

2025/03/06 12:16:45 health(warnable=dns-forwa2025/03/06 12:16:45 peerapi: handleDNS fwd error: waiting for response or error from [192.168.2.153:53]: context deadline exceeded 2025/03/06 12:16:45 peerapi: handleDNS fwd error: waiting for response or error from [192.168.2.153:53]: context deadline exceeded 2025/03/06 12:16:40 peerapi: handleDNS fwd error: waiting for response or error from [192.168.2.153:53]: context deadline exceeded 2025/03/06 12:16:40 peerapi: handleDNS fwd error: waiting for response or error from [192.168.2.153:53]: context deadline exceeded

 

Also the exit node is not working, i enabled it in unraid but as soon i switch to unraid as exit node my internet connection on smartphone is broken

Thanks for updating the plugin and allow it to select the exit node natively from the plugin as well as the feature to "allow lan". Any chance to make the exit-node description a bit better? For those from Mullvad-VPN, it show the short version rather than the country name. Also, Mullvad is not all together, but mixed with the other. The prior implementaiont (pre-upgrade) was much better and also even allowed to search (e.g., I could search for Miami and then the Mullvad-VPN for Miami came up). Thanks for considering!

  • Author
8 hours ago, steve1977 said:

Thanks for updating the plugin and allow it to select the exit node natively from the plugin as well as the feature to "allow lan". Any chance to make the exit-node description a bit better? For those from Mullvad-VPN, it show the short version rather than the country name. Also, Mullvad is not all together, but mixed with the other. The prior implementaiont (pre-upgrade) was much better and also even allowed to search (e.g., I could search for Miami and then the Mullvad-VPN for Miami came up). Thanks for considering!

Thanks for the suggestion, this will be included in the next release :)

Excellent. Thank you! Can you remind what I need to do to access dockers remotely. Something with subnets, but I forgot what. Is there a guide? Thanks!

  • 2 weeks later...

Hi, I found that my unraid server is able to connect to the internet, but I cannot ping or connect to the local IP (192.168.1.224) or hostname for the server (e.g. tower.local). Diagnostics attached.

 

I've already tried:

Rebooting the router

Changing the USB drive to another port and rebooting again

Reconnecting the ethernet cable to the router 

Rebooting the server numerous times

 

When I go to Connect, I can see my server, and any of the connections through my cloud flare tunnel (e.g. "plex.cloudflaredomain.com") still work. But, nothing on the local network seems to work, including apps like Scripted to connect to HomeKit (though home.scrypted.app still connects to the server). 

 

Attempting to ping the server from my computer yields a Request Timeout immediately. 
 

when I disabled the Tailscale plugin, everything started working again locally. 
 

my network settings are set to ipv4 only already 

  • Author

 

Just now, joshsalvi said:

I need the Tailscale diagnostics (see the pinned post). Those include tailscale logs, additional information about tailscale settings, etc. 

 

However, in the meantime — 99% of the time, the symptoms that you described are a result of enabling the “Use Tailscale Subnets” option in the advanced settings of the plugin. If that’s on, try turning it off. 

Trying to use my unraid server as an exit node, but there is no internet connectivity for clients using the exit node. Can make it work if I add this rule `iptables -A POSTROUTING --source 100.64.0.0/10 -o shim-br0 -j MASQUERADE -t nat`.

I haven’t seen anywhere where any iptable rules need to be added. Appears it should just work by allowing the tailscale plugin as an exit node.

 

Attaching the diagnostics. Would very much appreciate support on this. Thanks

Apollo-tailscale-diag-20250323-135627.zip

  • Author
11 hours ago, sean86 said:

Trying to use my unraid server as an exit node, but there is no internet connectivity for clients using the exit node. Can make it work if I add this rule `iptables -A POSTROUTING --source 100.64.0.0/10 -o shim-br0 -j MASQUERADE -t nat`.

I haven’t seen anywhere where any iptable rules need to be added. Appears it should just work by allowing the tailscale plugin as an exit node.

 

Attaching the diagnostics. Would very much appreciate support on this. Thanks

Apollo-tailscale-diag-20250323-135627.zip 207.58 kB · 0 downloads

This is probably because of your tailscale_pihole instance that's running on br0. I'm guessing that's set up as your DNS server in the tailscale admin console (probably by the local IP address).

I'd probably set up a Tailscale sidecar for that container, then put the Tailscale IP in the admin console: https://edac.dev/unraid/tailscale/docker-sidecar/

4 hours ago, EDACerton said:

This is probably because of your tailscale_pihole instance that's running on br0. I'm guessing that's set up as your DNS server in the tailscale admin console (probably by the local IP address).

I'd probably set up a Tailscale sidecar for that container, then put the Tailscale IP in the admin console: https://edac.dev/unraid/tailscale/docker-sidecar/

Thanks. But tailscale_Pihole is the sidecar tailscale container for Pihole. I also have the sidecar tailscale ip as the dns in the admin console ie. 100.64.0.x. 
 

the only difference is that i am using headscale as my coordination server. 

The Tailscale plugin on both my unRAID v6.11.5 servers updated a day or two ago and they are both giving an error now.

 

First off, I pretty much immediately got this email alert from both servers after updating:

 

Fatal error: Uncaught Error: Class 'Tailscale\Utils' not found in /usr/local/emhttp/plugins/tailscale/include/common.php:9
Stack trace:
#0 /usr/local/emhttp/plugins/tailscale/pre-startup.php(7): require_once()
#1 {main}
  thrown in /usr/local/emhttp/plugins/tailscale/include/common.php on line 9

 

And if I go into Settings > Tailscale, I see this:

 

Oops!
Something unexpected has occurred, and this page cannot be loaded.

Please report the following error on the plugin support thread:

Error Object
(
    [message:protected] => Class 'Tailscale\Utils' not found
    [string:Error:private] => 
    [code:protected] => 0
    [file:protected] => /usr/local/emhttp/plugins/tailscale/include/common.php
    [line:protected] => 9
    [trace:Error:private] => Array
        (
            [0] => Array
                (
                    [file] => /usr/local/emhttp/plugins/tailscale/include/Pages/Tailscale.php
                    [line] => 6
                    [function] => require_once
                )

            [1] => Array
                (
                    [file] => /usr/local/emhttp/plugins/tailscale/include/page.php
                    [line] => 31
                    [args] => Array
                        (
                            [0] => /usr/local/emhttp/plugins/tailscale/include/Pages/Tailscale.php
                        )

                    [function] => include
                )

            [2] => Array
                (
                    [file] => /usr/local/emhttp/plugins/tailscale/include/page.php
                    [line] => 11
                    [function] => Tailscale\includePage
                    [args] => Array
                        (
                            [0] => /usr/local/emhttp/plugins/tailscale/include/Pages/Tailscale.php
                            [1] => Array
                                (
                                )

                        )

                )

            [3] => Array
                (
                    [file] => /usr/local/emhttp/plugins/dynamix/include/DefaultPageLayout.php(693) : eval()'d code
                    [line] => 6
                    [function] => Tailscale\getPage
                    [args] => Array
                        (
                            [0] => Tailscale
                        )

                )

            [4] => Array
                (
                    [file] => /usr/local/emhttp/plugins/dynamix/include/DefaultPageLayout.php
                    [line] => 693
                    [function] => eval
                )

            [5] => Array
                (
                    [file] => /usr/local/emhttp/plugins/dynamix/template.php
                    [line] => 82
                    [args] => Array
                        (
                            [0] => /usr/local/emhttp/plugins/dynamix/include/DefaultPageLayout.php
                        )

                    [function] => require_once
                )

        )

    [previous:Error:private] => 
)

 

Pretty much all the tabs under Tailscale (Settings, Status, Lock, etc) give a similar error there too, with just different .php I think.

 

It does appear to still be working/connecting though I think(?), as I can see both my unRAID servers in my active devices on other Tailscale clients and I can still connect to my remote server's unRAID GUI over the Tailscale IP.

  • Author
4 minutes ago, deusxanime said:

The Tailscale plugin on both my unRAID v6.11.5 servers updated a day or two ago and they are both giving an error now.

 

First off, I pretty much immediately got this email alert from both servers after updating:

 

Fatal error: Uncaught Error: Class 'Tailscale\Utils' not found in /usr/local/emhttp/plugins/tailscale/include/common.php:9
Stack trace:
#0 /usr/local/emhttp/plugins/tailscale/pre-startup.php(7): require_once()
#1 {main}
  thrown in /usr/local/emhttp/plugins/tailscale/include/common.php on line 9

 

And if I go into Settings > Tailscale, I see this:

 

Oops!
Something unexpected has occurred, and this page cannot be loaded.

Please report the following error on the plugin support thread:

Error Object
(
    [message:protected] => Class 'Tailscale\Utils' not found
    [string:Error:private] => 
    [code:protected] => 0
    [file:protected] => /usr/local/emhttp/plugins/tailscale/include/common.php
    [line:protected] => 9
    [trace:Error:private] => Array
        (
            [0] => Array
                (
                    [file] => /usr/local/emhttp/plugins/tailscale/include/Pages/Tailscale.php
                    [line] => 6
                    [function] => require_once
                )

            [1] => Array
                (
                    [file] => /usr/local/emhttp/plugins/tailscale/include/page.php
                    [line] => 31
                    [args] => Array
                        (
                            [0] => /usr/local/emhttp/plugins/tailscale/include/Pages/Tailscale.php
                        )

                    [function] => include
                )

            [2] => Array
                (
                    [file] => /usr/local/emhttp/plugins/tailscale/include/page.php
                    [line] => 11
                    [function] => Tailscale\includePage
                    [args] => Array
                        (
                            [0] => /usr/local/emhttp/plugins/tailscale/include/Pages/Tailscale.php
                            [1] => Array
                                (
                                )

                        )

                )

            [3] => Array
                (
                    [file] => /usr/local/emhttp/plugins/dynamix/include/DefaultPageLayout.php(693) : eval()'d code
                    [line] => 6
                    [function] => Tailscale\getPage
                    [args] => Array
                        (
                            [0] => Tailscale
                        )

                )

            [4] => Array
                (
                    [file] => /usr/local/emhttp/plugins/dynamix/include/DefaultPageLayout.php
                    [line] => 693
                    [function] => eval
                )

            [5] => Array
                (
                    [file] => /usr/local/emhttp/plugins/dynamix/template.php
                    [line] => 82
                    [args] => Array
                        (
                            [0] => /usr/local/emhttp/plugins/dynamix/include/DefaultPageLayout.php
                        )

                    [function] => require_once
                )

        )

    [previous:Error:private] => 
)

 

Pretty much all the tabs under Tailscale (Settings, Status, Lock, etc) give a similar error there too, with just different .php I think.

 

It does appear to still be working/connecting though I think(?), as I can see both my unRAID servers in my active devices on other Tailscale clients and I can still connect to my remote server's unRAID GUI over the Tailscale IP.

Please provide plugin diagnostics, following the instructions in the pinned post.

 

Also, please be aware that I will be dropping support for 6.11 in an upcoming update (it's now 2 versions behind), so you might want to look at updating your server.

11 minutes ago, EDACerton said:

Please provide plugin diagnostics, following the instructions in the pinned post.

 

Also, please be aware that I will be dropping support for 6.11 in an upcoming update (it's now 2 versions behind), so you might want to look at updating your server.

 

Attached the diagnostics.

 

And understood on updating. I'm planning on bringing my server down to do my spring cleaning and dust blowout of it soon (if it ever warms up here!) and I'll be updating to v6.12.X then. 

 

yggdrasil-tailscale-diag-20250325-172218.zip

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

Account

Navigation

Search

Search

Configure browser push notifications

Chrome (Android)
  1. Tap the lock icon next to the address bar.
  2. Tap Permissions → Notifications.
  3. Adjust your preference.
Chrome (Desktop)
  1. Click the padlock icon in the address bar.
  2. Select Site settings.
  3. Find Notifications and adjust your preference.