How to use zellij on an Android phone or tablet

Last updated: 15 November 2026

You can attach to a zellij session running on a Linux or Mac machine from an Android phone or tablet in three ways: Muxr, zellij's own web client in a mobile browser, or an SSH app such as Termux or ConnectBot running zellij attach. Muxr fits when you want a purpose-built zellij client; the web client fits when you want no app, and an SSH app fits when you cannot install anything on the server.

What do I need?

How do I set it up with Muxr?

The quick start has screenshots for every step. The short version for Android:

  1. Get Muxr from Google Play.
  2. On the machine that runs zellij, install the server, muxrd, and its setup TUI, muxrctl:
    curl -fsSL https://raw.githubusercontent.com/f0x-it-llc/muxr-core/main/install.sh | bash
  3. Install Tailscale on the machine and on your phone, and sign both into the same tailnet.
  4. Run muxrctl on the machine. The setup wizard opens on first run and ends with a QR code.
  5. In the app, tap the QR scan button on the Connect screen and scan the code before you press Done.

The free app is the full app with one server. Muxr Pro is a one-time $19.99 purchase, 50% off ($9.99) until January 13, 2027.

What is different on an Android tablet?

From the 840 dp width breakpoint, the app switches to its tablet layout. A persistent pane rail sits at the left of the terminal and replaces the phone's floating button and bottom sheet. Connect uses two columns, and Sessions and Settings become master-detail screens.

On a phone you open the same controls from the floating button in the lower corner. The usage guide describes both layouts.

Can I unlock saved servers with my fingerprint or face?

Yes. Saved credentials are kept in the Android Keystore, gated behind your device's biometrics. When you tap a saved server on the Connect screen, a biometric prompt unlocks its token. There is no Muxr account, and the app has no analytics, ads or crash reporting. Saving more than one server needs Muxr Pro.

Can I do this without installing a server daemon?

Yes. Android offers a browser route and an SSH route, each with its own trade-offs; the facts below are as published on 15 November 2026.

The zellij web client as an installable web app. It ships with zellij, is off by default and starts with zellij web. The zellij documentation says it detects mobile browsers, offers touch scrolling, on-screen keys, pane and tab pickers and single-pane fullscreen, and can be installed as a web app. HTTPS is required when it listens on anything other than 127.0.0.1, login tokens are required, and a reverse proxy is recommended because there is no built-in rate limiting. It is free, but it is a zellij feature, so it does not attach to herdr. See Compare Muxr with the zellij web client.

An SSH app running zellij attach. Termux is a free Android terminal emulator distributed through F-Droid and GitHub; run ssh inside it and then zellij attach. ConnectBot is an Apache-2.0 SSH client for Android. Any SSH client can run zellij attach, and the machine needs just an SSH server. You get the ordinary zellij interface at the phone's screen size. This suits you if you already live in an SSH app or cannot install a daemon. See Compare Muxr with SSH and zellij.

Which gestures and keys work?

See the usage guide for every key.

What if it does not connect?

More answers are in the FAQ.