Connecting to your Mac
When your dedicated Mac mini is ready we email you an address, an SSH port, a username and a link that shows the password once. This page covers what to do with them, and what to do when something does not work.
01What you get
A whole Mac mini, not a container or a shared account. You are the only person
who logs in. Your account is a standard macOS user account: you cannot use
sudo or change the machine's system settings and network configuration
— those stay with us so that the machine keeps working and stays isolated from
other customers.
Outbound connections to port 25 are blocked, so the machine cannot talk directly to mail servers. To send email from your app, use a mail provider over port 587 or 465. Ports 23, 135, 137–139, 445, 1433 and 3389 are blocked as well, because they are common targets for scanning. If your work needs one of them, write to us.
Ready when you log in:
- Xcode 27.2 with the iOS 27.2 Simulator. Your use is subject to
Apple's licence terms, which you
accepted at checkout.
To use a different Xcode for one command, set
DEVELOPER_DIR. - Homebrew at
/opt/homebrew, yours for the whole lease:brew installworks without a password. Casks go to~/Applicationswith--appdir=~/Applications. - The App Store: sign in with your own Apple Account and install apps as usual.
Two ways in, both included:
- SSH — for builds, scripts and CI. This is what most people use.
- Screen sharing (VNC) — a full macOS desktop, for Xcode, Simulator, signing dialogs and anything else that needs a real screen.
02Reaching the machine
Nothing to join and no account to create. Your machine is reachable over SSH at the address and port on your machine page. Several machines share one public address, so the port is what tells them apart — always include it.
A Mac with SSH open to the internet gets a steady stream of login attempts, so we limit what can get in: from the internet only your rental account can sign in, the machine’s own administrator account cannot, and each connection gets three tries. Your password is long and random; keep it in a password manager, or switch to a key (below).
Screen sharing is never open to the internet. It runs inside your SSH connection, which encrypts it end to end.
03SSH
On a Mac or Linux open Terminal. On Windows 10 or 11 open PowerShell: SSH is built in, there is nothing to install. Then:
ssh -o PubkeyAuthentication=no -p 22002 mbc-xxxxxxxx@203.0.113.10
Use the port, username and address from your machine page. The first connection
asks you to confirm the host key; type yes. The password does not show
while you type.
-o PubkeyAuthentication=no stops your computer from offering its own
keys first. Without it, a computer with several keys can use up the three tries
before it asks for the password, and you see
Too many authentication failures.
Prefer keys to passwords. On a Mac or Linux, add your public key once and you will
not be asked for the password again; from then on you can leave out
-o PubkeyAuthentication=no:
ssh-copy-id -o PubkeyAuthentication=no -p 22002 mbc-xxxxxxxx@203.0.113.10
04Screen sharing
Step 1 — open the tunnel. Run this and leave the window open for as long as you use the desktop. It looks like an ordinary SSH session; closing it closes the desktop too.
ssh -o PubkeyAuthentication=no -p 22002 -L 5901:127.0.0.1:5900 mbc-xxxxxxxx@203.0.113.10
Step 2 on a Mac. Nothing to install. Your machine page has an open the desktop link, or open Finder, press ⌘K, and enter:
vnc://localhost:5901
Step 2 on Windows. Install TigerVNC Viewer: free, a single program, no account needed. Connect to:
localhost::5901
Two colons mean “port 5901”. We do not recommend RealVNC for this: its current version asks you to create a RealVNC account first.
Sign in with the same username and password.
macOS then asks how you want to connect, and the two choices do very different things. Pick the one that logs you in as yourself: that gives you your own desktop. The other choice asks to watch the machine’s own display, which is not your desktop at all — you get a lock screen you cannot sign in to, and no session of your own. If that is what you are looking at, quit Screen Sharing, connect again, and pick the first option this time.
The first time you log in to the desktop, macOS shows a Sign in with your Apple Account screen. You can sign in, or skip it: choose Other Sign-In Options, then Set Up Later. Anything you sign in to is removed with your account when the lease ends.
What it feels like. The machines are in Hong Kong. From the US the desktop responds in about 0.15–0.3 seconds: typing, clicking and Xcode are fine, while fast scrolling and video stutter. Closer to Hong Kong it is better. For repetitive work, SSH is the better tool. In TigerVNC, leave the colour level on its default; the lowest settings give a blank screen with a Mac.
05Restarting
Your machine page has a Restart this Mac button. It is a normal graceful restart, the same as choosing Restart from the Apple menu — your files, your accounts and everything you installed are untouched. Anything running at the time stops, so finish or stop your build first.
A restart takes about a minute. You can restart once every ten minutes; if you need it more often than that, something else is wrong and we would rather hear about it.
06When something does not work
| What you see | What it usually means |
|---|---|
| Times out | Check the address and the port on your machine page; the port is different for every machine. Some office and hotel networks block outgoing SSH on unusual ports — try another network. |
| Too many authentication failures | Your computer offered its own keys first and used up the tries. Add -o PubkeyAuthentication=no, as in the commands above. |
| Screen sharing: connection refused, or “actively refused” (10061) on Windows | The tunnel is not open. Run the Step 1 command first and keep that window open. |
| bind: Address already in use | Something on your computer already uses port 5901. Use 5902 in both places: -L 5902:127.0.0.1:5900, then localhost:5902. |
| SSH refused | The machine is restarting. Give it a minute; your machine page shows its current state. |
| Permission denied | Wrong username or password. The username always starts with mbc-. If you lost the password, press Set a new password on your machine page (on a team, someone with billing access can do it), or email us. |
| Black screen | Screen sharing connected but the Mac is at the login window. Sign in over SSH once, or restart from your machine page. |
| Authentication failed, and it never asks for a password | Your Mac saved the old password for this machine and is sending that one. This happens after you reset the machine. Remove the saved password in Keychain Access, or run security delete-internet-password -s localhost, then connect again. |
| A lock screen that is not yours | You picked the connection option that watches the machine’s own display instead of logging you in. Quit Screen Sharing, connect again, and choose the option that logs you in as yourself. |
| Not responding | Your machine page says we have not heard from the machine in five minutes. We see this too. If it does not clear on its own, email us. |
07When the lease ends
Every plan renews automatically, and the paid-through date on your machine page moves forward. We email you before that date — six hours ahead on the daily plan, one day ahead on the weekly plan, three days and one day ahead on the monthly plan, and seven days and three days ahead on the quarterly and yearly plans. A daily plan is only a day long, so a three-day warning would arrive before you had even started.
When a lease ends — you cancelled, or the payment never went through — we lock the machine first: you cannot log in, so copy anything you want to keep before the end date. Nothing is deleted yet. If you cancelled, your account and files stay on the locked machine for 24 hours; renting again in that time gives you the same machine back, unlocked, exactly as you left it. That is also the only way to get files off it once it is locked.
If a renewal payment fails, the machine keeps running while you update your card — 3 hours on the daily plan, 24 hours on the weekly plan, 3 days on longer plans — and is then locked and held for 24 hours, 2 days or 3 days respectively. Paying during that time unlocks it as it was.
After the hold the machine is reclaimed: we delete your account on the machine, erase its home directory, and remove the apps and Homebrew packages you installed. Copy anything you want to keep before then — we do not keep a copy, and we cannot get it back for you afterwards.
08Getting help
Email support@macbuildcloud.com. Tell us the machine address and port and what you were doing; that is usually enough for us to see the problem from our side.