MOSH(1) General Commands Manual MOSH(1)NAME
mosh-server - server-side helper for mosh
SYNOPSIS
mosh-server new [-s] [-v] [-i IP] [-p port] [-c colors] [-- command...]
DESCRIPTION
mosh-server is a helper program for the mosh(1) remote terminal application.
mosh-server binds to a high UDP port and chooses an encryption key to protect the session. It prints both on standard output, detaches from
the terminal, and waits for the mosh-client to establish a connection. It will exit if no client has contacted it within 60 seconds.
By default, mosh-server binds to a port between 60000 and 61000 and executes the user's login shell.
On platforms with utempter, mosh-server maintains an entry in the utmp(5) file to indicate its process ID, whether the session is con-
nected, and the client's current IP address.
mosh-server exits when the client terminates the connection.
OPTIONS
The argument "new" must be first on the command line to use command-line options.
-s bind to the local interface used for an incoming SSH connection, given in the SSH_CONNECTION environment variable (for multihomed
hosts)
-v Print some debugging information even after detaching.
-i IP IP address of the local interface to bind (for multihomed hosts)
-p PORT
UDP port number to bind
-c COLORS
Number of colors to advertise to applications through TERM (e.g. 8, 256)
-l NAME=VALUE
Locale-related environment variable to try as part of a fallback environment, if the startup environment does not specify a charac-
ter set of UTF-8.
EXAMPLE
$ mosh-server
MOSH CONNECT 60001 UAkFedSsVJs2LfMeKyQB5g
mosh-server (mosh 1.1)
[...] (copyright notice omitted)
[mosh-server detached, pid = 20443]
SEE ALSO mosh(1), mosh-client(1).
Project home page: http://mosh.mit.edu
AUTHOR
mosh was written by Keith Winstein <mosh-devel@mit.edu>.
BUGS
Please report bugs to mosh-devel@mit.edu. Users may also subscribe to the mosh-users@mit.edu mailing list, at
http://mailman.mit.edu/mailman/listinfo/mosh-users
February 2012 MOSH(1)
Check Out this Related Man Page
MOSH(1) General Commands Manual MOSH(1)NAME
mosh - mobile shell with roaming and intelligent local echo
SYNOPSIS
mosh [options] [--] [user@]host [command...]
DESCRIPTION
mosh (mobile shell) is a remote terminal application that supports intermittent connectivity, allows roaming, and provides speculative
local echo and line editing of user keystrokes.
Compared with ssh, mosh is more robust -- its connections stay up across sleeps and changes in the client's IP address -- and more respon-
sive, because the protocol is tolerant of packet loss and the client can echo most keystrokes immediately, without waiting for a network
round-trip.
mosh uses ssh to establish a connection to the remote host and authenticate with existing means (e.g., public-key authentication or a pass-
word). mosh executes the unprivileged mosh-server helper program on the server, then closes the SSH connection and starts the mosh-client,
which establishes a long-lived datagram connection over UDP.
To improve responsiveness, mosh runs a predictive model of the server's behavior in the background, trying to guess the effect of each key-
stroke on the screen. It makes predictions for normal typing, backspace, and the left- and right-arrow keys. When it is confident, mosh
displays the predictions without waiting for the server. The predictive model must prove itself anew on each row of the terminal and after
each control character, so mosh avoids echoing passwords or non-echoing editor commands.
By default, mosh shows its predictions only on high-latency connections and to smooth out network glitches. (On longer-latency links, the
predicted cells are underlined until confirmed by the server.) Occasional echo mistakes are corrected within a network round-trip and do
not cause lasting effect.
mosh does not support X forwarding or the non-interactive uses of SSH, including port forwarding or sshfs. mosh works through typical
client-side network address translators but requires UDP to pass between client and server. By default, mosh uses the ports between 60000
and 61000, but allows the user to request a particular UDP port instead.
mosh will do its best to arrange a UTF-8 character set locale on the client and server. The client must have locale-related environment
variables that specify UTF-8. mosh will pass these client variables to the mosh-server on its command line, but in most cases they will not
need to be used. mosh-server first attempts to use its own locale-related environment variables, which come from the system default config-
uration (sometimes /etc/default/locale) or from having been passed over the SSH connection. But if these variables don't call for the use
of UTF-8, mosh-server will apply the locale-related environment variables from the client and try again.
OPTIONS
command
Command to run on remote host. By default, mosh executes a login shell.
--client=PATH
path to client helper on local machine (default: "mosh-client")
--server=COMMAND
command to run server helper on remote machine (default: "mosh-server")
The server helper is unprivileged and can be installed in the user's home directory.
--ssh=COMMAND
OpenSSH command to remotely execute mosh-server on remote machine (default: "ssh")
An alternate ssh port can be specified with, e.g., --ssh="ssh -p 2222".
--predict=WHEN
Controls use of speculative local echo. WHEN defaults to `adaptive' (show predictions on slower links and to smooth out network
glitches) and can also be `always` or `never'.
The MOSH_PREDICTION_DISPLAY environment variable controls this setting permanently and can adopt the same three values.
Even on `always', mosh will only show predictions when it is confident. This generally means a previous prediction on the same row
of the terminal has been confirmed by the server, without any intervening control character keystrokes.
-a Synonym for --predict=always
-n Synonym for --predict=never
-p NUM, --port=NUM
Use a particular server-side UDP port, for example, if this is the only port that is forwarded through a firewall to the server.
Otherwise, mosh will choose a port between 60000 and 61000.
ESCAPE SEQUENCE
The escape sequence to shut down the connection is Ctrl-^ . (typically typed with Ctrl-Shift-6, then a period). To send a literal Ctrl-^,
type Ctrl-^ ^.
ENVIRONMENT VARIABLES
MOSH_PREDICTION_DISPLAY
Controls local echo as described above.
MOSH_TITLE_NOPREFIX
When set, inhibits prepending "[mosh]" to window title.
SEE ALSO mosh-client(1), mosh-server(1).
Project home page: http://mosh.mit.edu
AUTHOR
mosh was written by Keith Winstein <mosh-devel@mit.edu>.
BUGS
Please report bugs to mosh-devel@mit.edu. Users may also subscribe to the mosh-users@mit.edu mailing list, at
http://mailman.mit.edu/mailman/listinfo/mosh-users
February 2012 MOSH(1)