Troubleshooting

Why do my sessions drop when I leave the app?

Keep SSH sessions open when you leave Wardterm on iPhone or iPad: Keep Sessions Open in Background, Keep This Session with tmux, reconnection and Mosh.

What you see

You come back to the app and the session says Connection lost, then Trying again in 3 s. Nothing you type is sent.

After it reconnects: Reconnected in a new shell. Programs from the old one may have ended.

Why it happens

  • Keep sessions open in background is off. When you switch apps or lock the screen, iPhone and iPad pause Wardterm after a short while and its connections close.
  • The Live Activity was removed from the Lock Screen. Removing it closes the open sessions.
  • The network changed, for example from Wi-Fi to cellular, and the connection dropped. A plain session then ends on the server, with what runs in it.

What to do

  1. In Settings, Sessions, turn on Keep sessions open in background. It is on by default.
  2. Leave the Live Activity on the Lock Screen while you want the sessions open.
  3. For work that must not stop, open the menu of the session, ..., choose Keep This Session, then Continue. The session keeps running on the server in tmux, and Wardterm attaches to it again when the network is back: Back in your session. Nothing was lost. See Keep sessions alive.
  4. Keep Reconnect automatically on, in Settings, Sessions.
  5. On a server with Mosh installed, turn on Mosh: the session picks up again when the phone changes network. See Mosh.