You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: clarify systemd unit placement and sudo requirements per permission (#613)
Explain which systemd unit location is used for each schedule-permission
value, and make it clear that `user` still requires sudo while
`user_logged_on` does not. Add a tip pointing users toward lingering as
the path to rootless always-on scheduling.
Copy file name to clipboardExpand all lines: docs/content/schedules/configuration.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -75,9 +75,9 @@ profile:
75
75
76
76
*`system`: Access system or protected files. Run resticprofile with `sudo` on Unix and with elevated prompt on Windows. On Windows, resticprofile will automatically request elevated permissions if needed.
77
77
78
-
*`user`: Run the backup using current user permissions. Suitable for saving documents or files within your profile. **This mode runs even when the user is not logged on**. It will ask for your user password on Windows. It needs root permission (via sudo) when using `systemd`.
78
+
*`user`: Run the backup using current user permissions. Suitable for saving documents or files within your profile. **This mode runs even when the user is not logged on**. It will ask for your user password on Windows. On Linux with `systemd`, this creates a system unit with `User=` set — it requires root permission (via sudo) to schedule, but the backup itself runs as the unprivileged user. If you want to schedule without sudo, use `user_logged_on` with [lingering](https://wiki.archlinux.org/title/Systemd/User#Automatic_start-up_of_systemd_user_instances) enabled instead.
79
79
80
-
*`user_logged_on`: **Not for crond** - Provides the same permissions as `user`, but runs only when the user is logged on. On Windows, it does not ask for your user password.
80
+
*`user_logged_on`: **Not for crond** - Provides the same permissions as `user`, but runs only when the user is logged on (unless [lingering](https://wiki.archlinux.org/title/Systemd/User#Automatic_start-up_of_systemd_user_instances) is enabled). On Linux with `systemd`, this creates a unit in the user's systemd profile (`~/.config/systemd/user/`) and does **not** require sudo to schedule. On Windows, it does not ask for your user password.
81
81
82
82
**empty*: resticprofile will guess based on how it was started (with sudo or as a normal user). The fallback is `system` on Windows and `user_logged_on` on other platforms.
|**system**| system service | can run any time | can run any time | yes |
67
+
|**user**| system service with User= field defined | can run any time | can run any time | yes |
68
+
|**user_logged_on**| user service | runs only when user is logged on | can run any time | no |
69
+
70
+
{{% notice tip %}}
71
+
If you want to run backups as a regular user without root privileges at scheduling time, use `permission: user_logged_on`. To allow the schedule to run even when the user is not logged in, enable [lingering](https://wiki.archlinux.org/title/Systemd/User#Automatic_start-up_of_systemd_user_instances) for your user:
0 commit comments