Skip to content

Commit 35ecedb

Browse files
committed
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.
1 parent d012a24 commit 35ecedb

File tree

1 file changed

+11
-11
lines changed
  • documentation/asciidoc/services/connect

1 file changed

+11
-11
lines changed

documentation/asciidoc/services/connect/use.adoc

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -191,6 +191,17 @@ To re-enable screen sharing, do one of the following:
191191
$ rpi-connect shell on
192192
----
193193

194+
== Enable remote shell at all times
195+
196+
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:
197+
198+
[source,console]
199+
----
200+
$ loginctl enable-linger
201+
----
202+
203+
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.
204+
194205
== Manage devices
195206

196207
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%"]
203214

204215
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.
205216

206-
== Enable remote shell at all times
207-
208-
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:
209-
210-
[source,console]
211-
----
212-
$ loginctl enable-linger
213-
----
214-
215-
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.
216-
217217
== Update
218218

219219
To update to the latest version of Connect, run the following command:

0 commit comments

Comments
 (0)