.nh
.TH LTSP-REMOTEAPPS 8 "2023-08-19" "LTSP 23.02-1+deb12u1" "LTSP Manual"
.SH NAME
.PP
\fBltsp remoteapps\fP - run applications on the LTSP server via ssh -X

.SH SYNOPSIS
.PP
\fBltsp\fP [\fIltsp-options\fP] \fBremoteapps\fP \fIapplication\fP [\fIparameters\fP] ...
.br
\fBltsp\fP [\fIltsp-options\fP] \fBremoteapps\fP [\fB-r\fP \fIregister\fP] \fIapplication\fP ...

.SH DESCRIPTION
.PP
Setup passwordless SSH, by ensuring that ~/.ssh/authorized_keys contains one
of the public user's SSH keys. Then execute \fB\fCssh -X server app params\fR\&.
If the user has no SSH keys, a new one is generated.
For \fB\fCltsp remoteapps app\fR to work, /home/username should already be mounted via
NFS (on LTSP client boot) or SSHFS (on LTSP user login).

.SH OPTIONS
.PP
See the \fBltsp(8)\fP man page for \fIltsp-options\fP\&.

.TP
\fB-r\fP, \fB--register\fP
Register the specified applications as remoteapps, by creating symlinks in
/usr/local/bin/\fIapplication\fP for each one of them. Since \fB\fC/usr/local/bin\fR
usually comes before \fB\fC/usr/bin\fR in \fB\fC$PATH\fR, the remoteapps should be invoked
even if the application is selected from the system menu.

.SH EXAMPLES
.PP
The following ltsp.conf parameter can be used to register the MATE applications
\fB\fCusers-admin\fR (Menu ▸ System ▸ Administration ▸ Users and Groups) and
\fB\fCmate-about-me\fR (Menu ▸ System ▸ Preferences ▸ Personal ▸ About Me) as
remoteapps:

.PP
.RS

.nf
[clients]
REMOTEAPPS="users-admin mate-about-me"
.fi
.RE

.PP
That way, LTSP users are able to change their passwords or display names.
The password change takes effect immediately, while for the new display name
to appear in the LTSP client, the sysadmin must run \fB\fCltsp initrd\fR and the
client needs to be rebooted.

.SH COPYRIGHT
.PP
Copyright 2019-2022 the LTSP team, see AUTHORS.

.SH SEE ALSO
.PP
\fBltsp\fP(8), \fBltsp.conf\fP(5), \fBltsp-dnsmasq\fP(8), \fBltsp-image\fP(8),
\fBltsp-info\fP(8), \fBltsp-initrd\fP(8), \fBltsp-ipxe\fP(8), \fBltsp-kernel\fP(8),
\fBltsp-nfs\fP(8)

.PP
Online documentation is available on https://ltsp.org