SuitestDrive - Troubleshooting

If you cannot find the solution to your problem in the troubleshooting section, please contact our customer support.

Restart SuitestDrive

Restart SuitestDrive after applying any fixes to allow changes to take effect.


Device controlled by SuitestDrive has SUITESTDRIVE TURNED OFF status

In order to control device, SuitestDrive needs to be running. If one of the devices operated by this SuitestDrive shows up with status SUITESTDRIVE TURNED OFF then SuitestDrive is not running or the computer does not have a stable Internet connection.

Submitting SuitestDrive logs

Please, submit your SuitestDrive logs after an error occurred to help us with identifying your potential issues.

In the Control Units page, you can submit logs from any of the SuitestDrive in your organization (including SuitestDrive running on the CandyBox).

Submit logs from SuitestDrive

Submit logs from SuitestDrive on CandyBox

Cannot open SuitestDrive on macOS Catalina

If you are unable to open SuitestDrive on macOS Catalina. Please do the following:

  1. Navigate to where the SuitestDrive application is extracted.
  2. Right-click on SuitestDrive and select "Open".
  3. In the dialog select "Open the file anyway".

SuitestDrive should then launch normally and these steps should not have to be repeated.

Issues with SuitestDrive running on hardware control unit

You can restart or disable the SuitestDrive. To do this, do the following:

  1. Go to your Control units.
  2. Open the drop-down next to the hardware control unit.
  3. Press restart or disable.

Control units - Raspberry Pi drop-down

Important: Do not unplug the USB without disabling the SuitestDrive first, otherwise, you risk damaging the SuitestDrive installation.

Older versions of Microsoft Edge

If you encounter issues with running Suitest with Microsoft Edge it may be that your version of Microsoft Edge is outdated. You should enable Windows Updates to ensure that your browser remains at the newest version.

Problems with downloading dependencies

If you encounter issues with downloading dependencies for some of the platforms that SuitestDrive supports, please do the following:

  1. In SuitestDrive open File > Open SuitestDrive Config folder

    Open SuitestDrive Config folder - location

  2. In .suitest folder, navigate to resources.

  3. Delete the contents of the resources folder.

  4. Restart SuitestDrive and try to add the device again.

SuitestDrive automatic updates on Mac

Due to the specifics of a security protocol on Mac SuitestDrive cannot update itself when it has been launched from the default Downloads folder. Please unzip the SuitestDrive first and then move it to any other folder (like your Desktop or Applications folder) to benefit from automatic updates.

SuitestDrive would like to receive keystrokes from any application

macOS users might see a warning about SuitestDrive wanting to receive keystrokes when it is opened for the first time. This happens due to the way SuitestDrive is built. We do not do any keystrokes tracking. You can easily deny access and SuitestDrive will remain functional.

Warning from macOS