From d012a24d10eb86e80694bf3c23fcaac46cc67bc0 Mon Sep 17 00:00:00 2001 From: Paul Mucur Date: Thu, 4 Jul 2024 14:32:19 +0100 Subject: [PATCH 1/2] Update logging instructions for Connect 1.3.0 --- documentation/asciidoc/services/connect/troubleshooting.adoc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/documentation/asciidoc/services/connect/troubleshooting.adoc b/documentation/asciidoc/services/connect/troubleshooting.adoc index 700d68619b..4a58968eef 100644 --- a/documentation/asciidoc/services/connect/troubleshooting.adoc +++ b/documentation/asciidoc/services/connect/troubleshooting.adoc @@ -39,9 +39,11 @@ Enter the following lines of configuration between the comments: [source,bash] ---- ExecStart= -ExecStart=/usr/bin/rpi-connect-start -v +ExecStart=/usr/bin/rpi-connectd -socket %t/rpi-connect-wayvnc.sock -v ---- +NOTE: You need **both** lines that begin with `ExecStart=`. + Finally, restart the service with the following command: [source,console] From 35ecedb8351023e89382f9cf2075327eb7ce3f3c Mon Sep 17 00:00:00 2001 From: Paul Mucur Date: Thu, 4 Jul 2024 14:32:41 +0100 Subject: [PATCH 2/2] Put user-lingering instructions with remote shell To reduce the risk of users missing the importance of user-lingering when making remote shell available at all times, bring it above the "Manage devices" section after the other remote shell documentation. --- .../asciidoc/services/connect/use.adoc | 22 +++++++++---------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/documentation/asciidoc/services/connect/use.adoc b/documentation/asciidoc/services/connect/use.adoc index 8217fea489..1f86cca85c 100644 --- a/documentation/asciidoc/services/connect/use.adoc +++ b/documentation/asciidoc/services/connect/use.adoc @@ -191,6 +191,17 @@ To re-enable screen sharing, do one of the following: $ rpi-connect shell on ---- +== Enable remote shell at all times + +Connect runs as a user-level service, not as root. As a result, Connect only works when your user account is currently logged in on your Raspberry Pi. This can make your Raspberry Pi unreachable if you reboot with automatic login disabled. To continue running Connect even when you aren't logged into your device, enable **user-lingering**. Run the following command from your user account to enable user-lingering: + +[source,console] +---- +$ loginctl enable-linger +---- + +TIP: We recommend enabling user-lingering on all headless Raspberry Pi OS Lite setups to prevent your device from becoming unreachable after a remote reboot. + == Manage devices The Connect dashboard lists all of the Raspberry Pi devices linked with your Raspberry Pi ID and shows you the various ways you can access them. @@ -203,17 +214,6 @@ image::images/device-details.png[width="80%"] Deleting a device from Connect automatically signs you out of Connect on the device. The Connect system tray icon turns grey and the menu only provides a **Sign in** option. -== Enable remote shell at all times - -Connect runs as a user-level service, not as root. As a result, Connect only works when your user account is currently logged in on your Raspberry Pi. This can make your Raspberry Pi unreachable if you reboot with automatic login disabled. To continue running Connect even when you aren't logged into your device, enable **user-lingering**. Run the following command from your user account to enable user-lingering: - -[source,console] ----- -$ loginctl enable-linger ----- - -TIP: We recommend enabling user-lingering on all headless Raspberry Pi OS Lite setups to prevent your device from becoming unreachable after a remote reboot. - == Update To update to the latest version of Connect, run the following command: