User guide for Mocha X11

How it works

Mocha X11 will listen on port 6000 for any clients. On the iPhone/iPad running Mocha X11, start a Mocha Client. This client will use a standard TCP protocol, such as TELNET or SSH, to establish a connection to the UNIX/Linux server, and after user validation start a normal X11 application on the UNIX/Linux host. This X11 application will make a connection the Mocha X11 on port 6000, and ask the Mocha X11 to open a window.

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

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.