# How do I upload an iOS build from a remote Mac?

> Archive, export and upload an iOS build to App Store Connect from a remote Mac over SSH: xcodebuild and xcrun altool in 6 steps, per Apple's docs.

- URL: https://remotemacmini.com/guides/how-to-upload-an-ios-build-from-a-remote-mac/
- Last updated: 2026-11-17
- Publisher: RemoteMacMini (https://remotemacmini.com)

**Quick answer — How do I upload an iOS build from a remote Mac?**

Over SSH, archive the app with `xcodebuild archive`, export an .ipa with `xcodebuild -exportArchive`, then send it with `xcrun altool --upload-app`. Apple emails you once the build is processed. App Store Connect needs iOS apps built with Xcode 26 or later. An **RemoteMacMini** Mac mini, from $76.50 a month, runs every step without a screen.

**In brief**

- **Role needed**: Account Holder, Admin, App Manager or Developer in App Store Connect.
- **Xcode rule**: iOS apps built with Xcode 26 or later; upload with Xcode 14 or later, altool or Transporter.
- **Tools**: `xcodebuild` for archive and export, `xcrun altool` for validation and upload, Transporter as a Mac app.
- **Credentials**: an app-specific password, or an App Store Connect API key (`--apiKey`, `--apiIssuer`).
- **After upload**: the build is processed, then appears in App Store Connect and TestFlight.

## What are the steps over SSH?

**Six steps with Apple's command line tools. MyApp stands for your workspace and scheme names.**

1. **List the schemes** — Run xcodebuild -list -workspace MyApp.xcworkspace to see the scheme to archive.
2. **Archive** — Run xcodebuild -workspace MyApp.xcworkspace -scheme MyApp -archivePath build/MyApp.xcarchive archive.
3. **Export the .ipa** — Run xcodebuild -exportArchive -archivePath build/MyApp.xcarchive -exportPath build/export -exportOptionsPlist ExportOptions.plist. Get the plist from one export in Xcode.
4. **Validate** — Run xcrun altool --validate-app -f build/export/MyApp.ipa -t ios -u <username> -p <app-specific password>.
5. **Upload** — Run the same line with --upload-app instead of --validate-app. With an API key, use --apiKey <key ID> --apiIssuer <issuer ID> instead of -u and -p.
6. **Wait for processing** — Apple emails you when processing ends; the build then shows in App Store Connect and TestFlight.

## Which Xcode can build for App Store Connect on each macOS?

**iOS uploads need Xcode 26 or later, and each Xcode needs a minimum macOS.**

*Xcode versions able to build iOS apps for App Store Connect and the macOS they need, per Apple's pages read 17 November 2026*

| Xcode | macOS needed | Fits a RemoteMacMini Mac on |
| --- | --- | --- |
| Xcode 27, 27.1, 27.2 | macOS Tahoe 26.6 or later | macOS 26 Tahoe, updated to 26.6+ |
| Xcode 26.4.1, 26.5, 26.6 | macOS Tahoe 26.2 or later | macOS 26 Tahoe |
| Xcode 26.3 | macOS Sequoia 15.6 or later | macOS 15 Sequoia (15.6+) or macOS 26 Tahoe |
| Xcode 16.4 and older | macOS Sequoia 15.3 or later for 16.4 | Too old: iOS uploads need Xcode 26 or later |

## Should you use an API key or an app-specific password?

**An App Store Connect API key, for anything automated.** Apple's upload page shows altool with a user name and password; Flutter's release guide shows the same upload with `--apiKey` and `--apiIssuer`. Apple's TN3147 notes that the key's .p8 file can sit in `~/.appstoreconnect/private_keys/`, and the same key works for notarization.

An API key needs no Apple Account session on the Mac. RemoteMacMini never needs the customer's Apple Account; signing in to one on the Mac is the customer's choice. Keep the .p8 file out of the repository and readable only by your user.

## Can you upload without the command line?

**Yes: Transporter, or Xcode's own Distribute App flow, through Screen Sharing.** Apple describes Transporter as a Mac app that uploads builds and shows delivery logs; it comes from the Mac App Store. React Native's publishing guide uses Xcode's Product → Archive → Distribute App → App Store Connect → Upload.

Both need the Mac's screen, reached through an SSH tunnel. According to RemoteMacMini's survey of 17 November 2026, a comparable M4 with 16 GB rented from $85 a month at MyRemoteMac (excluding tax); RemoteMacMini's Pip costs $76.50. Framework specifics are on the [Flutter page](https://remotemacmini.com/flutter-ios-build-server/ "How do I build a Flutter iOS app without a Mac?") and the [React Native page](https://remotemacmini.com/react-native-ios-build-server/ "How do I build a React Native iOS app without a Mac?"); Xcode itself is covered by the [install guide](https://remotemacmini.com/guides/how-to-install-xcode-from-the-command-line/ "How do I install Xcode from the command line?").

## Uploading iOS builds from a remote Mac: common questions

### How long does processing take after upload?

Apple gives no fixed time. It sends an email when processing is complete, and the build then appears in App Store Connect.

### Which App Store Connect role can upload?

Account Holder, Admin, App Manager or Developer, per Apple's upload page.

### Is altool still supported for uploads?

Yes for uploads: Apple's upload page lists altool and Transporter for all target types. Only notarization moved from altool to notarytool.

### Why was my build rejected for its Xcode version?

App Store Connect accepts iOS apps built with Xcode 26 or later. Install a newer Xcode, which may first need a newer macOS.

### Does the remote Mac need my Apple Account signed in?

No. An App Store Connect API key or an app-specific password on the command line is enough.

**Verdict**

- **Archive, export, validate, upload**: four commands take an iOS build from a remote Mac to App Store Connect.
- **Match Xcode to macOS first**: Xcode 26 or later is required, and a RemoteMacMini Mac ships with macOS 26 or 15 from $76.50 a month.

## Sources

1. [Upload builds](https://developer.apple.com/help/app-store-connect/manage-builds/upload-builds) — Apple Developer (read 2026-11-17)
2. [Xcode system requirements](https://developer.apple.com/xcode/system-requirements/) — Apple Developer (read 2026-11-17)
3. [Building from the Command Line with Xcode FAQ (TN2339)](https://developer.apple.com/library/archive/technotes/tn2339/_index.html) — Apple Developer (read 2026-11-17)
4. [TN3147: Migrating to the latest notarization tool](https://developer.apple.com/documentation/technotes/tn3147-migrating-to-the-latest-notarization-tool) — Apple Developer (read 2026-11-17)
5. [Build and release an iOS app](https://docs.flutter.dev/deployment/ios) — Flutter (read 2026-11-17)
6. [Publishing to Apple App Store](https://reactnative.dev/docs/publishing-to-app-store) — React Native (read 2026-11-17)

**Ship iOS builds from a Mac you rent, $76.50 a month** macOS 26 Tahoe or 15 Sequoia, SSH and Screen Sharing, paid in crypto. [Rent Pip for 1 month](https://remotemacmini.com/app/checkout/?plan=pip&term=1m&from=guides-how-to-upload-an-ios-build-from-a-remote-mac&lang=en) · [All guides](https://remotemacmini.com/guides/ "Which remote Mac guides does RemoteMacMini publish?")

---

RemoteMacMini: RemoteMacMini rents dedicated Apple Mac minis (M4 and M4 Pro) in data centres for building, signing and testing iOS and macOS apps: one whole Mac per customer, reached over SSH and Screen Sharing. Five plans cost $76.50 to $247.49 a month, each 10% under the lowest comparable offer read on 17 November 2026, paid in crypto with no ID document.
