LET’S GET YOU CONNECTED

TailTerm support.

TailTerm 0.3.0 is being prepared as a free App Store release for iPhone, iPad and Mac. Downloads are not available yet. This page covers the upcoming App Store apps.

Before your first connection

  1. Install the official Tailscale app on your Apple device and destination computer, then connect both to your Tailscale network.
  2. Enable SSH on the destination. On Mac, enable Remote Login in System Settings. Make sure your network policy permits the connection.
  3. Create a Tailscale OAuth client with devices:core:read permission. Enter its client ID, secret and tailnet in TailTerm’s connection settings. Your network administrator may need to create this client. Tailscale’s OAuth documentation.
  4. Choose a computer and its computer username, then sign in using an SSH key, password or Tailscale SSH as supported by that computer. Verify the host key before trusting it.
  5. Choose a running session, or start a new terminal. Install tmux on the destination for persistent shared sessions.

You can also choose Explore demo to try the interface without connecting to a computer.

My computer or session is missing

Check that Tailscale is connected on both devices, the computer is awake, and your network policy allows SSH. Refresh the computer list. A discovered computer may still need SSH login setup before sessions can be listed.

TailTerm finds tmux sessions, including cmux’s private server. A regular terminal window without a shared session cannot be resumed from another device. Use the app’s session-sharing guidance on the source computer.

A host key changed

Stop and verify the new fingerprint with the computer’s owner or administrator. A changed key may follow a legitimate reinstall, but it can also indicate a different computer. Do not bypass verification just to make a connection work.

Where did my uploaded file go?

Uploads go to private temporary directories on the selected remote computer. TailTerm inserts the quoted remote path into your prompt. It does not press Return. Remove uploaded copies on that computer when you no longer need them.

Reset saved data

On iPhone or iPad, use Settings → Forget all saved data. On Mac, close session tabs, then use Tailnet settings → Forget all saved data… and confirm. This clears local saved data; remote sessions, uploads and history remain on your computers.

Get in touch

Email Tomas Cupr at work@tomcupr.com. Include the TailTerm version, device and operating system, what you expected, and what happened. A screenshot can help, but remove private information first.

Please never send passwords, private keys, OAuth secrets or private terminal transcripts. Read the privacy policy.