User guide for Mocha X11

How it works

Mocha X11 uses a client-server model: The Mocha X11 terminal communicates with various client programs on Linux/UNIX Servers. Mocha X11 accepts requests for graphical windows and sends back user input from keyboard and mouse.

Mocha X11 will listen on TCP port 6000 for any clients. On the iPhone/iPad running Mocha X11, start a client inside Mocha X11. This client will use Telnet or SSH, to establish a session to the remote Server.
After user validation, it will start an X11 application on the Server. This X11 application can make a connection back to Mocha X11 on port 6000, and request Mocha X11 to open a window.

It is also possible to use a SSH tunnel to route all X11 traffic in a secure way. The SSH tunnel will also makes it possible to access a Server from a device on another network, such as an iPhone using only a cell network.

Example A: Mocha X11 at IP
SSH/Telnet---------->Start xterm DISPLAY=
Listen<----------Connect to
<----------Send X11 data
Display xterm

Example B: Mocha X11 on an iPhone using Cell network:
SSH---------->Make SSH tunnel with X forwarding
SSH Server listen at port 6010
SSH---------->Start xterm, DISPLAY=localhost:10
<----------Send X11 data using the tunnel
Display xterm

Getting started

In most cases there is not any need to configure the X11 Terminal. If clients should not be started direct from the UNIX/Linux server, first a set of clients must be configured. See Configure a client

Hereafter click on "START" , and the Mocha X11 terminal will listen for traffic on port 6000. If a client should be started, click on the menu icon in the black banner:

If the client window is not displayed, use Client Log from the menu, and look for any error messages.

Configure X11 Terminal

Configure a client

In menu - Clients Advanced configuration are parameters valid for all clients:

User interface



Keyboard scroll banner

A scroll banner with extra keys can be shown on top of the normal keyboard, or using the extra keys icon (second from the left) in the black status bar for the window. Use the small arrow up at the right side of the banner to get a second banner on top. Keys [shift] [drag] and [hover] can be double clicked, as a lock function.
Hide the scroll banner with a tap on the [hide] button.

Black tool bar

Wireless keyboard: fn (f1-f12) cannot be used, but

Solving connection problems

If a client does not start, use menu - Client log to look for any error messages.

As default many UNIX/Linux servers will block port 23 and telnet. It will be easier to use SSH (Secure Shell). The Secure Shell client in Mocha X11 supports only password validation. Certificates are not supported.