Install OS X Server and Configure the Xcode Service

To run the Xcode service, install and configure OS X Server and Xcode on a Mac running OS X Mavericks. You can then write code on a separate development Mac and let the server perform continuous integrations of your software products.

The Xcode service advertises itself over Bonjour on your local network. If you and other users will access the Xcode service only from your local network, you can use Bonjour to find the Xcode service. If you need the service to be visible more broadly, ask your DNS server administrator to add records for the new server running OS X Server to a DNS server. After these records are added, users can access the server by its host name, such as server.mycompany.com. If your intranet doesn’t have a DNS server, you and others can access the server by its local hostname, such as server.local.

Download OS X Server and Xcode

To install OS X Server on a Mac

  1. Download OS X Server from the App Store.

    Open the App Store app on the Mac that will be your server, and search for OS X Server.

    The Mac must run OS X v10.9 or later. If you have an earlier version, click Updates in the App Store toolbar and upgrade OS X before installing OS X Server.

    After you download OS X Server from the App Store, the Server app is installed and opens automatically.

  2. Click Continue in the OS X Server setup window (or click Help to see detailed setup instructions).

    ../art/ServerInstallScreen_2x.png../art/ServerInstallScreen_2x.png
  3. Follow the onscreen instructions to complete the installation.

    After you enter the name and password of an administrator account on your Mac, the Server app installs the software it needs, and the Server app configures your Mac as a server.

You must also install Xcode on the server. Even if you don’t use Xcode directly on the server while developing software, the Xcode service uses Xcode to run its bots.

To install the Xcode app

Set Up the Xcode Service for Yourself

With the Xcode and Server apps installed, you’re ready to start the Xcode service.

To start the Xcode service from the Server app

  1. Launch the Server app (if it’s not already running).

    You can click the Launchpad icon in the Dock and then click Server.

  2. In the Server app sidebar, select the Xcode service.

    ../art/ServicesSidebar_2x.png
  3. Click Choose Xcode, and select Xcode 5 (or later).

    The first time you turn on the Xcode service for a particular server, the service asks you to identify the Xcode release it should use to perform its tasks.

  4. Click the On/Off switch to turn on the service.

Add your server to an Apple Developer Program Member Center team to allow the Xcode service to access Member Center assets, such as provisioning profiles and signing certificates to build products for iOS devices. You must be an admin or the agent of the team you want your server to join. (See the chapter “Managing Your Team” in App Distribution Guide for information about Apple Developer Program team roles.)

To add a server to an Apple Developer Program Member Center team

  1. In the Server app sidebar, select the Xcode service.

  2. Click Settings.

  3. In the Settings pane, click the Add button, associated with the Developer Teams label.

    ../art/DevTeamsAddButton_2x.png
  4. Sign in with your Apple Developer credentials.

  5. Choose a team, and click OK.

After adding a team to the Xcode service, you can add provisioned iOS development devices for use when running unit tests.

To add an iOS development device to the Xcode service

  1. In the Server app sidebar, select the Xcode service.

  2. Connect the device to the server, and wait until it appears in the devices list.

    A device must be provisioned to appear in the devices list. (To provision a device, follow the instructions in Provisioning Your iOS Device for Development in Devices Organizer Help.)

  3. Click the “Add to Team” button next to the device in the list.

On the development Mac, add an account for the server. With the server account added to your development Mac, you can check the status of bots in the Xcode log navigator. You can also create new projects and host them in Git repositories on the server.

To add an OS X Server account to Xcode on a development Mac

  1. Choose Xcode > Preferences on your development Mac.

  2. Click Accounts.

  3. Click the Add button (+), and choose Add Server.

  4. Select the server from the server list or enter a server address, and click the Next button.

  5. Specify your connection credentials to the server, and click Add.

    If the server is successfully enabled, you can click the server address link in the Accounts preferences in Xcode, and Safari will launch and show the bots website hosted by the server.

Set Up the Xcode Service for Team Members

If you are part of a team of developers, you can give the members user accounts on the server running OS X Server. They can then create and manage bots, share and manage source code repositories, and use other services in OS X Server.

To add a user account to the server

  1. In the Server app sidebar, select Users (under Accounts).

    For more details about creating user accounts, click the Help button in the lower-right corner of the Users pane.

  2. Click the Add button (+).

  3. Enter the user’s account information in the New User pane.

  4. Click Create.

You can also add and manage groups of user accounts by selecting Groups (under Accounts) in the Server app sidebar. For more details, click the Help button in the lower-right corner of the Groups pane.

In Xcode Accounts preferences on their development Mac computers, team members can add their account credentials for the server.

Anyone running Xcode who has access to the server can potentially create and view bots. You can restrict which users have access to bots by clicking the Edit button in the Settings pane in Xcode service.

To change permissions for who can create or view bots

  1. In the Server app sidebar, select the Xcode service.

  2. Click Settings.

    ../art/SettingsTab_2x.png
  3. Click the Edit button for Permissions.

  4. Choose which users can create and view bots.

    ../art/BotPermissions_2x.png

    If you choose “anyone” from the upper pop-up menu, guests and every authenticated user can view bots, create, edit, and delete bots, and download items. “Logged in users” includes local users and directory users, all of whom need to authenticate to have access to bots. Clicking “only some users” allows you to specify existing users or groups. If you don’t know the exact name of a user or group, clicking Add (+) and entering a space allows you to browse and filter the directory.

  5. If you chose to restrict bot creation, you can choose to restrict view-only access to bots.

    Users with view-only access can view the website, but they can’t create bots, manage bots, or initiate integrations. People who particularly benefit from having view-only access to bot activity are software testers, project managers, and seed coordinators.

  6. Click OK.

    As described in “Manage and Monitor Bots from a Web Browser,” these settings also affect users of the bots website hosted by the server.