# How to use zellij on an Android phone or tablet

> Attach to a zellij session from an Android phone or tablet with Muxr, the zellij web client or Termux. Setup steps, tablet layout and biometric unlock.

Source: https://muxr.app/how-to/zellij-on-android.html

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?

- A Linux or Mac machine running zellij (or herdr). The Muxr server, `muxrd`, is built against zellij 0.45.1 and refuses a mismatched version. It needs a Unix host, so Windows does not work.
- An Android phone or tablet running Android 10 or later, with Muxr installed from Google Play.
- A route from the phone to the machine, ideally a tailnet such as Tailscale.

## How do I set it up with Muxr?

The [quick start](https://muxr.app/docs.html) has screenshots for every step. The short version for Android:

1. Get Muxr from [Google Play](https://play.google.com/store/apps/details?id=com.it.f0x.muxr).
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](https://muxr.app/guide.html#tablet-differences) 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](https://zellij.dev/documentation/web-client) 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](https://muxr.app/compare/zellij-web-client.html).

**An SSH app running `zellij attach`.** [Termux](https://termux.dev/en/) is a free Android terminal emulator distributed through F-Droid and GitHub; run `ssh` inside it and then `zellij attach`. [ConnectBot](https://github.com/connectbot/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](https://muxr.app/compare/ssh-and-zellij.html).

## Which gestures and keys work?

- Tap a pane to focus it; tap the focused pane again for the soft keyboard.
- Double-tap a pane to toggle server-side pane fullscreen.
- Long-press text to select it, drag to extend, then tap Copy.
- The key bar has one-shot Ctrl and Alt latches, Esc, Tab, arrows, PgUp, PgDn and Del.
- The Android back gesture leaves immersive mode first, then asks whether to detach.
- Tap the floating button for the tabs and panes sheet.

See the [usage guide](https://muxr.app/guide.html#keyboard-bar) for every key.

## What if it does not connect?

- The QR will not scan or pairing fails: confirm `muxrd` is running, then follow the [support FAQ](https://muxr.app/support.html#faq).
- Connection refused or timed out: the server binds 127.0.0.1 by default, so reach it over a tailnet or a LAN bind address; see the [support FAQ](https://muxr.app/support.html#faq).
- Still stuck: email [support](https://muxr.app/support.html#contact) with the details under [before you write in](https://muxr.app/support.html#before-you-write-in).

More answers are in the [FAQ](https://muxr.app/faq.html).

**Related pages**

- [How to use zellij on iPhone and iPad](https://muxr.app/how-to/zellij-on-iphone-and-ipad.html)
- [All how-to guides](https://muxr.app/how-to/)
- [Pricing](https://muxr.app/pricing.html)
- [Frequently asked questions](https://muxr.app/faq.html)
