Quick Install

Run the following command in Terminal on your Mac to download and install ControlFloor:

$ curl -sL https://controlfloor.com/dl/install.sh | bash

This downloads the latest ControlFloor release and installs the Server and Provider binaries. You can also download the components manually from the links below.

Manual Downloads

If you prefer to download the packages manually:

Each package includes the Server, Provider, iOS apps, and utilities. Use the install script above for the easiest setup experience.

System Requirements

Component Requirement
macOS macOS 12 (Monterey) or later
Xcode Xcode 14+ (for iOS 16), Xcode 15+ (for iOS 17+)
Apple Developer Account Required for re-signing iOS apps ($99/year)
iOS Devices iOS 14 or later (USB connection required)
Hardware Any Mac with USB ports. Mac Mini recommended for device farms.
Python Python 3.8+ (for the Python API client)

iOS Version & Xcode Compatibility

Each iOS version requires a matching Xcode version to build and sign the on-device apps. Generally, use the latest Xcode that supports your target iOS version. For iOS 17+, you'll also need to configure an RSD tunnel method for device communication. See the Setup Guide for details.

What's Next?

After downloading, follow the setup guide to sign the iOS apps, configure your server, and connect your first device.

1

Sign iOS Apps

Re-sign CFA, VidStream, and UIInspector with your Apple Developer certificate.

2

Configure & Start

Edit the config files, start the Server and Provider, and register them.

3

Connect & Automate

Plug in devices, open the web dashboard, and start automating.

Read the Setup Guide Signing Guide