Installing Perfect Assistant

Pre-requisites before installing and using Perfect Assistant

In order to run Perfect Assistant, the following foundations are required:

  • Operating System: macOS 10.12 (Sierra), or later
  • Xcode 8.3.2 or later installed
  • Xcode 8.3.2 or later command line tools selected

Select the correct command line tools in Xcode

In the Xcode menu, select Preferences.

In the Locations preference pane (shown below), select an Xcode 8.x build.

Selecting the correct command line tools in Xcode

Download Perfect Assistant

Download the latest installer, mount the DMG file, and drag the Perfect Assistant Application into the Applications directory.

Move the application to the Applications Directory

Check for Updates to Perfect Assistant

In order to continue delivering the highest quality product, we periodically release updates to the Perfect Assistant. These updates will include not just bug fixes, but new features, templates and examples.

To update to the latest version of the Perfect Assistant, use the "Check for updates..." item in the Perfect Assistant application menu.

This will check the updates server for any newer releases, and if required will download and prompt you to install the newer version.

Configure Docker

Docker is an essential part of the local Linux build process. If you have not installed it previously, the Docker status area of the main window will display Docker is not installed. and will display the Install Docker Now button.


Click to begin the Docker app download. When the download has finished the dmg will be opened. Drag the into the Applications folder as instructed and then launch it.

Granting Permissions to Docker

The next step for connecting Docker to your Perfect Assistant is to grant the permissions to install components and links.


Once Docker has been installed and given a chance to fully launch, Perfect Assistant will automatically begin downloading the base images required for local Linux Builds.


This operation may take a bit of time, so please allow it to complete before attempting any local Linux builds. Local macOS builds are not affected by this process. After the images have downloaded the Update Docker Image button will permit you to periodically download updated images if available.

Next: Creating Projects