Mosh (software)

From Wikipedia, the free encyclopedia
Original author(s)Keith Winstein
Initial releaseMarch 12, 2012; 12 years ago (2012-03-12)
Stable release
1.4.0 / October 26, 2022; 18 months ago (2022-10-26)[1]
Operating systemUnix-like systems
TypeUtility software
LicenseGNU GPLv3 with OpenSSL and iOS exceptions Edit this at Wikidata

In computing, Mosh (mobile shell) is a tool used to connect from a client computer to a server over the Internet, to run a remote terminal.[2] Mosh is similar[3] to SSH, with additional features meant to improve usability for mobile users. The major features are:

  • Mosh maintains its session even when it "roams" (when the client endpoint changes to different IP addresses), for example by moving to a different Wi-Fi network or when changing from Wi-Fi to 3G.[4]
  • Mosh maintains the terminal session (not "connection" in the TCP-sense because Mosh uses UDP) even when a user loses their Internet connection or puts their client to "sleep". In comparison, SSH can lose its connection in such cases because TCP times out.[5]
  • A Mosh client attempts to be responsive to keyboard events (typing, erasing characters with the delete key, and so on) without waiting for network lag. It uses an adaptive system that predicts whether the application running on the server will decide to echo the user's keystrokes or deletions.[6][7]

The main drawbacks of Mosh are additional prerequisites to the server, that it lacks some special features of SSH (such as connection forwarding) and the lack of a native Windows client.[2] An alternative for Linux servers (that still require installation on the server) is to use GNU Screen on top of a regular SSH connection.


Mosh works at a different layer from SSH. Whereas SSH transmits a stream of bytes in each direction (from server to client or client to server) using TCP, Mosh runs a terminal emulator at the server to figure out what should be on the screen.[2] The server then transmits this screen to the client at a varying frame rate, depending on the speed of the network.[8] This allows Mosh to save on network traffic on slow or intermittent connections.

Supported platforms[edit]

Mosh is available for most Linux distributions, macOS, FreeBSD, NetBSD, and OpenBSD, Android, Solaris, Cygwin, and as a Chrome App.[2] The iOS program Termius includes an independent implementation of the Mosh protocol.[9]



Mosh is built on the State-Synchronization Protocol (SSP),[10] which supports single-packet roaming.[11] After the client has switched to a new IP address, a single packet that successfully reaches the server is enough to "roam" the connection. The client does not need to know it has roamed. (The client may be on a network with network address translation (NAT) when the NAT router roams.)[8]

Packet loss[edit]

In the Mosh research paper,[8] the creators tested SSP on a link with 29% packet loss, and found that SSP reduced the average response time by a factor of 50 (from 16.8 seconds to 0.33 seconds) compared with SSH, which uses TCP. A different study, by students at Stanford University, found that SSP reduced the average response time by a factor of 30 (from 5.9 seconds to 0.19 seconds).[12]

Local echo[edit]

According to Mosh's developers, the program was found to be able to predict and immediately display 70% of user keystrokes,[2][8] reducing the median response time to a keystroke to less than 5 milliseconds (masking the latency of the network). A different study, by students at Stanford University, found that Mosh was able to quickly echo 55% of user keystrokes.[13]


Compared to the more popular SSH, Mosh has the following drawbacks:

Prerequisites on the server[edit]

The major drawback of Mosh is that it requires the server to fulfill additional prerequisites which are not needed by ssh itself. Due to its design, Mosh needs the server to allow direct connections via UDP.[14] Servers not fulfilling these prerequisites cannot be used by Mosh. Examples of such systems include servers behind firewalls which restrict connections to the ssh-port via TCP. Also problematic are servers which are only indirectly reachable. The latter is usually accommodated by ssh via the 'ProxyCommand' option, but this is not supported by Mosh.[15]

One port per connection[edit]

By default, the server tries to allocate the first free UDP port in the range 60001–61000, per connection. This dynamic port allocation is considered an extra burden and risk for firewall maintenance.[16] A significant part of the firewall-filtering happens through connection tracking, so called stateful filtering, this is based on the SYN/ACK flags in TCP segments, UDP packets don't have such flags.[17]


  1. The UDP port on the server can be set per Mosh connection, so that only a limited number of ports need to be opened[18]
  2. Deep packet inspection firewalls and application firewalls can handle this better by looking at content of the packet and associate it to the initial connection

Output drops and lack of terminal scrollback[edit]

Scrollback is not supported in the current release of Mosh, and when using it in a terminal emulator with scrollbars they disappear, but is planned for the 1.3 release.[19] This functionality is a trade-off for garbage cleaning, as binary output is wiped away[clarification needed]. One way to mitigate this is by using Mosh in combination with a terminal multiplexer like screen or tmux.[20]

Lack of ssh-agent forwarding[edit]

ssh-agent forwarding is not currently supported.[21]

Lack of X11 forwarding[edit]

X11 forwarding is not yet supported.[22]

See also[edit]


  1. ^ "Release mosh-1.4.0 · mobile-shell/Mosh". GitHub.
  2. ^ a b c d e "Mosh: the mobile shell". Retrieved on 28 March 2013.
  3. ^ Brockmeier, Joe. "Into the Mosh Pit: A Mobile Shell Replacement for SSH" Archived 2014-03-20 at the Wayback Machine,, 10 April 2012. Retrieved on 28 March 2013.
  4. ^ Delony, David. "Mosh: Secure Shell Without the Pain", Technopedia, 19 October 2012. Retrieved on 28 March 2013.
  5. ^ Cox, John. "MIT researchers chart a new approach for mobile Internet protocols" Archived 2012-10-18 at the Wayback Machine, Network World, 6 July 2012. Retrieved on 28 March 2013.
  6. ^ Beckert, Axel. "Mosh and AutoSSH: Remote shell tools that make your life easier on a slow or constantly morphing network", Linux Magazine, November 2012.
  7. ^ Leyden, John. "MIT's mind-reading Mosh pits itself against SSH daemons", The Register, 13 April 2012. Retrieved on 28 March 2013.
  8. ^ a b c d Winstein, Keith. "Mosh: An Interactive Remote Shell for Mobile Clients", USENIX Annual Technical Conference 2012, Boston, Mass., 14 June 2012.
  9. ^ "Termius Features", Crystalnix.
  10. ^ "MIT unveils a new Internet protocol for mobile clients"
  11. ^ Winstein, Keith and Balakrishnan, Hari. "Mosh: An Interactive Remote Shell for Mobile Clients (more detailed draft)". Retrieved on 28 March 2013.
  12. ^ Nagaraj, Kanthi and McMilin, Emily. "Mosh", Reproducing Network Research, 14 March 2013. Retrieved on 28 March 2013.
  13. ^ Aljunied, Ahmed. "Evaluation of Mosh 'Mobile Shell' Performance Results", Reproducing Network Research, 13 March 2013. Retrieved on 28 March 2013.
  14. ^ "'Mosh will log the user in via SSH, then start a connection on a UDP port between 60000 and 61000.'", Retrieved on 19 June 2014.
  15. ^ "Mosh bug report #285: Can't use a ProxyCommand-based SSH connection", Retrieved on 18 June 2014
  16. ^ "Dangers of opening up a wide range of ports? (mosh)", IT Security (Stack Exchange), 13 April 2012. Retrieved on 28 March 2013.
  17. ^ Multiplexing more sessions into same UDP port
  18. ^ "use -p to define remote UDP port"
  19. ^ "Scrollback support is planned for version 1.3"
  20. ^ "Scrollback and alternate screen (was: Use alternate screen on smcup/rmcup)"
  21. ^ "SSH Agent Forwarding"
  22. ^ "Support X forwarding"