Installing Xcode on your hosted Mac

Below are three ways to install Xcode on your hosted Mac server, in order of preference.

Option 1: Xcodes (recommended)

Xcodes is an open source tool to install and switch between multiple Xcode versions. It comes as a GUI app and as a command line tool (xcodes). On a remote Mac the CLI is the most practical: it works over SSH and is easy to script.

Why we recommend it:

  • Fast downloads through aria2, using multiple connections

  • Installs several Xcode versions side by side and switches between them

  • Installs simulator runtimes

  • Can install from a local .xip file, so the server itself never needs your Apple ID

Install Xcodes

With Homebrew:

# command line tool
brew install xcodesorg/made/xcodes

# optional: aria2 for faster downloads (used automatically when present)
brew install aria2

# optional: the GUI app, if you work through Screen Sharing
brew install --cask xcodes

Common commands

# list available versions
xcodes list

# install the latest release
xcodes install --latest

# install a specific version
xcodes install 16.1

# faster extraction (experimental, uses more memory)
xcodes install --latest --experimental-unxip

# show installed versions and switch the active one
xcodes installed
xcodes select 16.1

# list and install simulator runtimes
xcodes runtimes
xcodes runtimes install "iOS 17.0-beta1"

Without an Apple ID on the server

Download the .xip once on your own computer (see option 2), copy it to your Mac and let xcodes handle the rest:

scp Xcode_16.1.xip admin@your-mac.example.com:~/Downloads/
xcodes install 16.1 --path ~/Downloads/Xcode_16.1.xip

Option 2: Download from the Apple Developer website

  1. Go to developer.apple.com/download/all and sign in with your Apple ID. A free Apple developer account is enough.

  2. Download the Xcode .xip you need. You can do this on your own computer and copy the file to the server with scp, or download it directly on the hosted Mac itself.

  3. Extract and move it into place:

cd ~/Downloads
xip --expand Xcode_16.1.xip
sudo mv Xcode.app /Applications/Xcode-16.1.app
sudo xcode-select -s /Applications/Xcode-16.1.app
sudo xcodebuild -license accept
sudo xcodebuild -runFirstLaunch

Option 3: Mac App Store (not recommended)

You can install Xcode from the App Store, but this requires signing in to the App Store on the server with your Apple ID. Other drawbacks:

  • Only the latest version is available, no side by side installs

  • Automatic updates can change the Xcode version under your builds without warning

  • It needs the GUI, so you have to work through Screen Sharing

Check your installation

xcode-select -p
xcodebuild -version

The first command shows the active Xcode path, the second the version and build number.

Why Xcode is not preinstalled

We deliver your Mac with a clean macOS install and leave Xcode out on purpose:

  • Size. Xcode is a download of several GB and takes considerably more disk space once extracted. Not every customer needs it, and many need a specific version rather than the latest.

  • Apple ID. Downloading Xcode requires signing in with an Apple ID. We do not want to link our Apple ID to your server, and we cannot use yours. Signing in and accepting the Xcode licence is up to you.

Questions or problems? Contact our support team.