Skip to main content
Skip table of contents

Installation

MyQ Desktop Client for macOS (MDC) can be manually installed to a single user’s workstation, or remotely installed to multiple workstations using Apple Remote Desktop.

Manual installation

This option allows users to manually install MDC, and to proceed with the configuration (see Preferences) after the installation is complete.

  1. Download the latest available version of the installation (.pkg) file from the MyQ Community portal.

  2. Double-click on the installation file. The installation wizard opens; click Continue.

  3. The Software License Agreement window opens; click Continue.

  4. In the next prompt, select Agree to agree to the terms of the software license agreement.

    Software license agreement prompt
  5. The Destination Select window opens and you can select where you would like to install MyQ Desktop Client, and click Continue.

    Selecting the installation destination
  6. The Installation Type window opens, where you can select the installation destination. Click Change Install Location to browse for a new destination or click Install to start the installation to the predefined destination.

    Installation Type window
  7. You are redirected to the Installation Type window, where you can click Install to start the installation.

  8. On the Authentication prompt window, enter your MacOS user’s Password and click Install Software.

  9. The Installation window opens where you can see the installation’s progress.

  10. The Summary window opens. It should indicate that the installation was successful. Click Close.

    Installation summary
  11. The MyQ Desktop Client app is now installed and open. Check Preferences for the steps to configure it.

Remote installation with Apple Remote Desktop

It is highly recommended to go through the manual installation in one workstation before deploying the app to multiple workstations. This way, the administrator can make sure that the installation and configuration is successful. Another advantage is that the administrator can copy the settings file of this manual installation and deploy it to the other workstations before remotely installing MDC. The settings then are applied to all the workstations, without the need to set them up individually after the installation.

The followings options must be enabled in the Mac workstations to allow the remote installation from the Apple Remote Desktop tool:

  1. In OS X, open System Preferences and click Sharing.

  2. In the Service list, select Remote Management and then click Options.

  3. Select the following options: ObserveControlOpen and quit applicationsChange settingsDelete and replace itemsRestart and shut down, Copy items.

  4. Click OK.

Sharing settings

Deploying the settings file

If you have manually installed and setup MDC, you can copy the settings file (available in /Users/<MacOSUserName>/Library/Preferences/cz.myq.mdc.plist) to the System Preferences Folder, and those settings will be applied to all the users in the Mac workstations.

  1. On the administrator Mac, open Finder and click Applications > Remote Desktop to display the main window of Apple Remote Desktop (ARD).

  2. Click All Computers in the left section of the ARD main window. The Mac workstations connected to your network are displayed in the right pane of the window.

  3. Select the desired destination Macs and click Copy in the ARD toolbar (or select Manage > Copy Items menu). The Copy Items window opens.

  4. Click Copy to copy the items to selected Macs. The progress is displayed in the main window. The result of the copy to each Mac is displayed in the Status column.

  5. The settings file is copied in: /Library/Preferences.

Deploying the settings file to multiple workstations

If the settings file is not copied, after the package installation finishes the user can configure MDC from the app’s Preferences option (see Preferences). The settings file will be created under the user’s home folder: ˜/Library/Preferences.

Deploying the Package

To deploy the package to multiple Mac workstations:

  1. On the administrator Mac, open Finder and click Applications > Remote Desktop to display the main window of Apple Remote Desktop (ARD).

  2. Click All Computers in the left section of the ARD main window. The Mac workstations connected to your network are displayed in the right pane of the window.

  3. Select the desired destination Macs and click Install in the ARD toolbar (or select Manage > Install Packages menu). The Install Packages window opens.

  4. Add the MyQ Desktop Client.pkg file (available for download in the MyQ Community portal) to the Packages list either by drag-and-drop or by locating the package using the plus (+) button.

  5. Click Install to distribute the package to the selected Macs. The installation progress is displayed in the main window. The result of the package distribution to each Mac is displayed in the Status column. 

Deploying the MDC package to multiple workstations

Installation by Admin for Normal User on the same Device

After installation of the MyQ Desktop Client, set up the connection to the MyQ server and save it with the admin user. Then navigate to \Library\Preferences and find cz.myq.mdc.plist.

Modify the permissions on the file - either add the other, non-admin MAC user(s) with Read & Write permissions or change rights of everyone from No access to Read & Write. After this, when logging in as the non-admin user, they will be connected to the MyQ server and after authentication, they can use MyQ Desktop Client.

image-20240709-080044.png

Saving configuration after installation as admin user

image-20240709-080248.png

Adding Read & Write permissions for non-admin users

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.