Skip to content

Add documentation for using Raspberry Pi Connect with Tailscale #3883

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 2 commits into from
Closed

Add documentation for using Raspberry Pi Connect with Tailscale #3883

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0fb23d0
Add documentation for using Raspberry Pi Connect with Tailscale
steveiliop56 Oct 14, 2024
65cf5c4
Add missing comma
steveiliop56 Oct 14, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 31 additions & 0 deletions documentation/asciidoc/services/connect/troubleshooting.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,37 @@ Finally, restart the service with the following command:
$ systemctl --user restart rpi-connect
----

==== Use Raspberry Pi Connect with Tailscale ====

Due to how Tailscale affects networking, if you use both Raspberry Pi Connect and Tailscale, you may face issues using screen sharing, chances are you will see an empty screen. To fix this, you can use Raspberry Pi Connect in mDNS mode. This can be accomplished by editing Raspberry Pi Connect's systemd unit file.

To do this, open the `rpi-connect` configuration file for editing with the following command:

[source,console]
----
$ systemctl --user edit rpi-connect-wayvnc
----

Enter the following lines of configuration between the comments:

[source,bash]
----
[Service]
ExecStart=
ExecStart=/usr/bin/rpi-connectd -socket %t/rpi-connect-wayvnc.sock -mdns
----

NOTE: You need **both** lines that begin with `ExecStart=`.

Finally, restart the service with the following command:

[source,console]
----
$ systemctl --user restart rpi-connect-wayvnc
----

Now Screen Sharing should be working perfectly with Tailscale running.

==== Enable enhanced logging in the dedicated `wayvnc` server

Open the configuration file for the dedicated WayVNC server associated with Connect:
Expand Down