Photo by Annie Spratt on Unsplash.

#SSH into Your Mac from an iPhone with Tailscale and tmux

Your Mac at home can be a surprisingly useful personal server. With Tailscale, SSH, and tmux, you can open a terminal from an iPhone, start a build or coding agent, close the mobile app, and reconnect later without losing the process.

No router port forwarding. No public VPS. No SSH service exposed directly to the internet.

This guide uses the simplest reliable setup:

• Tailscale creates a private, encrypted network between your devices.
• SSH gives you a normal remote shell.
• tmux keeps terminal sessions alive across disconnects.

#What you need

• A Mac running macOS 13 or later
• An iPhone or iPad
• One Tailscale account
• Homebrew on the Mac
• An SSH client on iOS, such as Termius or Blink Shell

The Mac must be powered on and connected to the internet. tmux survives an SSH disconnect, but it cannot keep a sleeping Mac reachable. For long-running jobs, we will use macOS's built-in caffeinate command.

#1. Install and connect Tailscale on the Mac

For most people, install the official macOS app from tailscale.com/download, open it, and sign in.

If you prefer Homebrew:

Code
Copy
Loading…

Open Tailscale and log in with the same account you will use on the iPhone. Then verify that the Mac is connected:

Code
Copy
Loading…

The second command should return a private Tailscale address in the 100.x.y.z range.

You can also use the Mac's MagicDNS hostname instead of its IP address. In the Tailscale admin console, give the Mac a short, recognizable device name such as home-mac.

#2. Enable the built-in SSH server

Open:

System Settings → General → Sharing → Remote Login

Turn it on and restrict access to Only these users. Select the macOS account that will run your development jobs.

From Terminal, confirm the current user and SSH setting:

Code
Copy
Loading…

The value from whoami is your SSH username. It is your local macOS account name, not your Apple ID email address.

If you prefer the command line, enable Remote Login with:

Code
Copy
Loading…

Before involving the iPhone, test SSH from another computer that is already on your tailnet:

Code
Copy
Loading…

Replace both placeholders. If this works, the Mac-side configuration is ready.

#3. Install tmux

Install tmux with Homebrew:

Code
Copy
Loading…

Create or reattach to one named session:

Code
Copy
Loading…

Inside tmux, start a job:

Code
Copy
Loading…

To leave the session running while disconnecting SSH, press:

Ctrl-b, then d

That is tmux's default detach shortcut. The process keeps running on the Mac.

Reconnect later with:

Code
Copy
Loading…

You can list sessions if you forget the name:

Code
Copy
Loading…

#4. Keep the Mac awake for long jobs

A disconnected SSH client does not stop tmux, but macOS sleep can stop network access or pause your workload.

Run a command through caffeinate when the Mac must stay awake:

Code
Copy
Loading…

For a long-running coding agent:

Code
Copy
Loading…

If the command exits, caffeinate exits too. This avoids changing permanent power settings just for one job. Make sure the Mac is plugged in and has enough disk space and memory for the workload.

#5. Connect from the iPhone

Install Tailscale from the App Store and sign in with the same account as the Mac. Turn the VPN on and confirm the Mac appears as an online device.

Then install an SSH client.

#Termius

Create a new host with:

For a first test, password authentication also works. Use the Mac's local login password—not necessarily the password for your Apple ID.

Once connected:

Code
Copy
Loading…

You now have a persistent remote development terminal in your pocket.

#6. Use an SSH key instead of a password

Password login is convenient for the first test, but an Ed25519 key is a better daily setup.

Create an Ed25519 key in Termius or Blink and copy its public key. On the Mac, add it to authorized_keys:

Code
Copy
Loading…

Paste the public key as one complete line, save, and reconnect using that key.

Do not disable password authentication until key login has been tested successfully. Keep a second recovery path available in case the key is pasted incorrectly.

#Optional: Tailscale SSH

Tailscale SSH can manage SSH authentication and authorization through your tailnet policy. It is useful when you want identity-based access instead of distributing SSH keys.

On macOS, the Tailscale SSH server requires the open-source tailscaled variant; the sandboxed App Store build cannot act as a Tailscale SSH server. For a standard personal Mac setup, regular macOS SSH over the Tailscale network is usually simpler and already avoids exposing port 22 publicly.

Read the current requirements in the Tailscale SSH documentation before switching.

#Troubleshooting

#Tailscale shows "NeedsLogin"

Sign in on the Mac and iPhone with the same Tailscale account. On the Mac:

Code
Copy
Loading…

#SSH says "Connection refused"

Check that Remote Login is enabled:

Code
Copy
Loading…

It should report "Remote Login: On". Also confirm that you are using the Mac's Tailscale IP, not its local Wi-Fi address.

#The Mac is not reachable

From another tailnet device:

Code
Copy
Loading…

If the ping fails, check that both Tailscale apps are active and that the Mac is awake.

#tmux says there is no session

List existing sessions:

Code
Copy
Loading…

If none exist, create one:

Code
Copy
Loading…

#The job stopped after disconnecting

Make sure it was started inside tmux. For jobs that require the Mac to remain awake, run them through caffeinate:

Code
Copy
Loading…

#Quick checklist

• Tailscale is connected on both devices.
• The Mac has a 100.x.y.z Tailscale address.
• Remote Login is enabled for the correct macOS user.
• SSH works before adding tmux.
• tmux contains the long-running process.
• caffeinate is used when sleep would interrupt the job.
• SSH keys are configured and tested before removing password access.

The result is a small, private, and inexpensive personal server: your Mac stays at home, while your terminal travels with you.

Further reading: Tailscale SSH, Tailscale on macOS, and tmux.