>>> SSH & tmux on iPad Your iPad Is A Terminal Now. With Real tmux Split Panes

Yes, you can SSH from an iPad, and do it properly. RETRO TMUX connects to your server, attaches to real tmux sessions and lays the panes out side by side, exactly like tmux does. Your work keeps running on the server when the iPad sleeps.

// Split panes //

Panes Side By Side. Exactly Like tmux

Most iPad terminals give you one screen at a time. RETRO TMUX draws tmux's own layout: your agent in one pane, logs in the other, each scrolling on its own even with the keyboard up. Tap a pane to type in it, double-tap to zoom it, double-tap again to put it back.

Illustration of RETRO TMUX on iPad. The real thing is in step 03 below.

// Why tmux //

iPadOS Pauses Apps. tmux Doesn't Care

Switch to Safari for a minute and iPadOS suspends your SSH app, connection and all. With plain SSH, the server hangs up on your shell and whatever was running dies. With tmux, your work lives on the server: the iPad can sleep, switch apps or lose Wi-Fi, and you pick up exactly where you left off.

plain SSH
  • You switch apps for a minuteConnection dropped, job killed
  • The iPad goes to sleepStart again from scratch
  • You move from iPad to laptopNew shell, empty screen
SSH + tmux
  • You switch apps for a minuteCome back, history intact
  • The iPad goes to sleepYour job keeps running
  • You move from iPad to laptoptmux attach, carry on

// Built for iPad //

An iPad Terminal With More Keys

A terminal app for iPad should use the iPad: the width, the keyboard, the multitasking.

A Full Desktop Keyboard

Wider screen, more keys, not bigger keys: number row, Esc, Tab, Ctrl, Alt, arrows and F1–F12 on the retro keyboard.

Hardware Keyboards

Connect a Bluetooth or Smart Keyboard and the on-screen keyboard steps aside while the key row stays. (Not yet verified with every keyboard; tell us if yours misbehaves.)

Split View & Stage Manager

Everything scales from the window it's in. Rotate, resize, run it next to Safari. No fixed layouts.

Never Squeezed

At least 80 columns and 24 rows, so full-screen programs like htop, vim and AI agents always get room to draw.

Keys In The Keychain

Generate an Ed25519 key on the iPad or import yours from Files, iCloud Drive or AirDrop. Keys stay on the device unless you choose iCloud Keychain.

One App, Both Devices

The same app runs on iPhone and iPad, so the session you started on one is a tap away on the other.

// Setup · about 5 minutes //

How To SSH From Your iPad

You need a server or computer you can SSH into (a cloud VPS, a Raspberry Pi, a Mac with Remote Login on) with tmux 3.0 or newer.

  1. 01

    Make sure tmux is on the server

    Most Linux servers install it in one command. Then start a named session for your work.

    $ sudo apt install tmux   # or: brew install tmux
    $ tmux new -s work
    you@server: ~
    $ tmux new -s work
    (a fresh shell, now living inside tmux)
    $ htop
    [work] 0:htop*"server" 14:02
  2. 02

    Add your server

    Tap + ADD HOST and enter the address. Generate an Ed25519 key on the iPad, install it with your password once, then use the key from then on. TEST SSH checks the key, the server and tmux before you save.

    RETRO TMUX hosts screen on iPad, ready to add a host
  3. 03

    Attach, and see the panes

    Tap your session. If it has split panes, they appear side by side exactly as tmux lays them out. Tap a pane to type in it; double-tap to zoom.

    RETRO TMUX on iPad: a tmux window with Codex in the top pane and two shell panes side by side below, with the full retro keyboard
  4. 04

    Leave whenever you like

    Switch apps, close the cover, go home. Detaching never kills the session. When you come back, each window shows what its agent is up to. Pick it up from the iPad, your iPhone or your laptop.

    # later, from any computer:
    $ tmux attach -t work
    RETRO TMUX on iPad: a session's windows with what each agent is doing, Codex idle and Hermes running

// Choosing an iPad SSH app //

Choosing An SSH Client For iPad

There are several good SSH apps for iPad. If you work in tmux, these are the things that matter, and how RETRO TMUX handles each.

What to checkWhy it mattersRETRO TMUX
Real tmux integrationSessions, windows and panes as tmux sees them, not just a shell that happens to run tmuxYes, through tmux control mode, with an ordinary attach as fallback
Panes side by sideUse the iPad's width instead of one pane at a timeYes, laid out exactly like tmux
A keyboard with Ctrl and EscTerminal programs are unusable without themAlways-visible key row, sticky Ctrl, F1–F12
Where your keys liveAn SSH key is a key to your serveriPhone/iPad Keychain. No account, no cloud of ours
Leaves your desktop aloneAttaching from the iPad shouldn't reshape your laptop's tmuxUses its own view and restores sizes on exit
Servers without tmuxNot every box you SSH into has tmuxPlain shell mode: an ordinary SSH login
AI agent awarenessKnow if Claude Code or Codex is working or waiting, without attachingWorking / needs you / done / idle

No tmux on that server? RETRO TMUX opens a plain SSH shell too. You just lose the parts that survive a sleeping iPad. Running AI agents? Here's how to use Claude Code or Codex on your iPhone. Comparing apps? Termius vs Blink vs Prompt.

// FAQ //

SSH On iPad, Answered

Can you SSH from an iPad?

Yes. iPadOS has no built-in terminal, but an SSH app like RETRO TMUX connects to your server with a password or an SSH key. RETRO TMUX then attaches to tmux on the server, so your work survives when the iPad sleeps.

Why does my SSH session die when I switch apps on iPad?

iPadOS suspends apps in the background, and the network connection goes with them. With plain SSH, that ends the shell and whatever was running in it. Inside tmux, the work keeps running on the server and you just reattach.

What is the best SSH client for iPad?

It depends on how you work. If you live in tmux or run AI coding agents on a server, pick an app built for tmux: panes side by side, a real Ctrl and Esc, and sessions that survive the iPad sleeping. That's what RETRO TMUX is built for, and it also opens a plain SSH shell on servers without tmux.

Does it work with a hardware keyboard?

It's built for it: with a Bluetooth or Smart Keyboard connected, the on-screen keyboard steps aside and the key row stays. We haven't verified it with every physical keyboard yet, so tell us if yours misbehaves.

Does it work with Stage Manager and Split View?

Yes. Everything scales from the window it's in, so it works in Split View, Stage Manager and any rotation, with no fixed layouts.

Do I need tmux on my server?

No, but you want it. Without tmux, RETRO TMUX opens a plain SSH shell (pick Plain shell when you add the host). It works, but the shell dies with the connection and there are no windows, panes or agent status. With tmux 3.0 or newer you get all of that, and installing it is one command on most servers, for example sudo apt install tmux.

>>> READY WHEN YOU ARE

ssh ipad@anywhere

RETRO TMUX is in beta. Join, and we'll tell you when there's a build to break.

+ JOIN THE BETA

More: what RETRO TMUX does · SSH on iPhone · Claude Code on iPhone

join-beta.sh— retro tmux —

>>> BETA ACCESS

Join The Beta

Tell us a little about your setup. We'll email you when there's a build to break. No newsletter, no spam, just the invite.

you'll use it on
agents you run
your server