Documentation

No results
    gitHub

    Mac

    Standard installation

    The application is shipped as a signed (with Hackolade's parent company IntegrIT NV Developer ID) .pkg file with an installation wizard automatically placing the app in the proper folder and displaying the License Agreement and Release Notes.  After downloading the application from our download page, double-click on the downloaded .pkg file and the wizard will start.  You will be prompted for your Mac username and password.

     

    Starting with the release of macOS 10.15 Catalina, Apple has introduced a new security feature that ensures that 3rd-party applications are manually granted access to the user's file.  Hackolade stores settings and logs in your Documents folder, and it cannot operate without it.  So, if prompted with this dialog, you must click OK.  

    Mac - access to Documents folder

     

    You may still manage this grant if needed in Security & Privacy:

    Mac Security Privacy

     

     

    The "Git" command requires the command line developer tools

    If you don't have XCode installed on your machine, it is possible that you will be presented with this message:

    Mac Git command line developer tools install

     

    You should install this these tools, then restart Hackolade Studio.

     

    To install the application without admin rights

    In a corporate environment if you don't have the admin password to perform installation, you should contact your IT department.  They can remotely access your computer and install the software for you.  You should comply with the IT policy on non-approved software.

    Mac install - admin password  Mac install - failed

     

    Nevertheless, it is possible to bypass this restriction and install Hackolade without admin rights.  You must be aware that the installation of the software is a tacit acceptance of our Terms and Conditions and End-User License Agreement, whether you use the installation wizard or follow the instructions below.

     

    Manual installation steps:

    1. download the application from our download page

     

    2. copy the downloaded file Hackolade-mac-setup-signed.pkg to the Desktop

     

    3. You may want to minimize and hide all windows by pressing Command+Option+H+M

    Mac install - step 2

     

    4. Open the search bar by pressing Command+Spacebar, search for terminal and press enter

    Mac install - step 4

     

    5. Type: pkgutil --expand , then drag-and-drop the .pkg file in the terminal window, followed by the folder path where you want to install the software, for example /Users/<homeFolderName>/HackoladeTMP and press enter to extract the package into the destination folder

    Mac install - step 5

     

    6. Open the destination temp folder HackoladeTMP

     

    7. You should see a package file Hackolade.pkg  Press Ctrl+Right-Click on the the Hackolade.pkg file and choose Show Content

    Mac install - step 7

     

    8. You will see a Payload file

    Mac install - step 8

     

    9. In the Terminal window, type the command: tar -xvf , then drag-and-drop the Payload file and add the -C argument (with an uppercase C) plus the final destination folder and press enter

    Mac install - step 9

     

    10.  You should see a list of filenames scroll through the window:

    Mac install - step 10

     

    11.  When the process is finished, if you access the destination folder, you should see the installed app:

    Mac install - step 11

     

    Double-click on the Hackolade.app icon to start the application.

     

    Silent installation

    Important license note: by installing or upgrading, you accept the license agreement for the application, even if the silent installation does not prompt you.

     

    The installer can be invoked in a Terminal window after download of the application pkg file in the Downloads folder.

     

    On Apple silicon arm64:

    sudo installer -target / -pkg $HOME/Downloads/Hackolade-macARM64-setup-signed.pkg

     

    On Intel 64-bit:

    sudo installer -target / -pkg $HOME/Downloads/Hackolade-mac-setup-signed.pkg

     

     

    Homebrew

    Important license note: by installing or upgrading, you accept the license agreement for the application, even if the silent installation does not prompt you.

     

    Homebrew is a package manager for for MacOS and Linux.  A package for Hackolade Studio has been published and is maintained by a kind member of the community.  Many thanks to him.

     

    If brew is not installed yet, please do so by following instructions in this page.  Note that brew requires the installation of XCode Command Line Tools.  

     

    The install command is 

     

    brew install --cask hackolade

     

    See this page for more details.