Dedicated Mac minis · M4 and M4 Pro · one whole Mac per customer · pay in BTC, USDT, USDC, ETH, SOL, LTC, XMR
Rent a Mac mini

Help center · access

How do I connect to a RemoteMacMini Mac?

Last updated: · 3 min read

Quick answer

How do I connect to a RemoteMacMini Mac?

Copy the login command from the RemoteMacMini dashboard and run it in a terminal: SSH opens with your key, or with the temporary password shown. For the macOS desktop, open an SSH tunnel to port 5900 and point a VNC client at localhost. Both use the same account, and port 5900 is never open to the internet.

In brief
  • SSH: the command shown under the Mac, with your key or the temporary password.
  • Desktop: Screen Sharing through ssh -L 5900:localhost:5900.
  • Clients: the macOS Screen Sharing app, or any VNC viewer on Windows and Linux.
  • First step: change a temporary password with passwd.

Which tool connects from which computer?

Ways to reach a RemoteMacMini Mac from macOS, Windows and Linux
FromTerminal (SSH)Desktop (Screen Sharing)
macOSTerminal: ssh user@IPScreen Sharing app at vnc://localhost:5900 after the tunnel
Windows 10 or 11PowerShell: built-in OpenSSH ssh user@IPA VNC viewer at localhost:5900 after the tunnel
Linuxssh user@IPRemmina or another VNC viewer at localhost:5900

How do I open the first SSH session?

Copy the command from the Mac's page in the dashboard and paste it into a terminal. With a key given at checkout, it logs in at once. Without one, type the temporary password shown, then run passwd to set your own; the shown password stops working. To add a key later, append your public key to ~/.ssh/authorized_keys on the Mac.

How do I open the macOS desktop safely?

Start a tunnel, then connect the viewer to your own machine. Run ssh -L 5900:localhost:5900 user@IP and keep it open. In a second window, open the VNC viewer at localhost:5900 and log in with the same macOS account. The traffic travels inside SSH, so nothing listens on the internet. Windows users find client choices in Screen Sharing from Windows.

How do I move files to and from the Mac?

Use scp or rsync over the same SSH login, or clone from your Git remote. For example: rsync -av ./MyApp/ user@IP:~/MyApp/. Large Xcode projects copy faster as a Git clone on the Mac. More options are in moving files to a remote Mac.

What if the connection fails?

Check the status first: only a Running Mac accepts connections. "Connection refused" right after delivery often means a typo in the user name. "Permission denied (publickey)" means the key in your agent is not the one given at checkout. According to RemoteMacMini's support rule, A person answers support emails within 12 hours, seven days a week. A Mac that stays unreachable is covered in a Mac that is late or unreachable.

Can several people use the same Mac?

Apple’s licence makes the customer the sole user of a leased Mac, so one team account works, but the Mac cannot be shared as a service. Members of the same team can log in with their own SSH keys added to ~/.ssh/authorized_keys, for builds and tests of that team’s software. Reselling access, or opening it to outside users, breaks the licence and the acceptable use policy.

How do I keep the session alive during long builds?

Run long jobs inside tmux or screen, or as a launch agent, so a dropped connection does not stop them. Install tmux with Homebrew (brew install tmux), start a session with tmux new -s build, run the build, and detach with Ctrl-B then D. Reattach later with tmux attach -t build. Adding ServerAliveInterval 60 to your SSH config also keeps idle tunnels open through home routers.

Connection questions

Which user do I log in as?

The user shown in the dashboard command. It has administrator rights: Full administrator rights: install Xcode, Homebrew, runners and any software, change any setting.

Can I use Apple Remote Desktop?

Screen Sharing is the supported path. Other remote desktop tools can be installed by you, over the SSH tunnel.

Is the desktop slow?

Screen Sharing over a tunnel suits Xcode and the Simulator. Builds and tests run faster from the command line over SSH.

Can I open other ports?

Yes, with administrator rights and the macOS firewall settings; keep remote access behind SSH where possible.

Verdict
  • Use SSH for builds and the tunnel for the desktop.
  • Never open port 5900 to the internet.

Pip is ready to build with SSH and Screen Sharing.

From $76.50/mo · no KYC

Rent a Mac