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

Guide · App Store Connect · Apple docs read 17 November 2026

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

Last updated: · 4 min read

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
XcodemacOS neededFits a RemoteMacMini Mac on
Xcode 27, 27.1, 27.2macOS Tahoe 26.6 or latermacOS 26 Tahoe, updated to 26.6+
Xcode 26.4.1, 26.5, 26.6macOS Tahoe 26.2 or latermacOS 26 Tahoe
Xcode 26.3macOS Sequoia 15.6 or latermacOS 15 Sequoia (15.6+) or macOS 26 Tahoe
Xcode 16.4 and oldermacOS Sequoia 15.3 or later for 16.4Too 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 and the React Native page; Xcode itself is covered by the install guide.

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 (6)
  1. Upload builds — Apple Developer (read 2026-11-17)
  2. Xcode system requirements — Apple Developer (read 2026-11-17)
  3. Building from the Command Line with Xcode FAQ (TN2339) — Apple Developer (read 2026-11-17)
  4. TN3147: Migrating to the latest notarization tool — Apple Developer (read 2026-11-17)
  5. Build and release an iOS app — Flutter (read 2026-11-17)
  6. Publishing to Apple 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.

From $76.50/mo · no KYC

Rent a Mac