Skip to main content

Installation

installation

NOTE

During the installation on Windows and Mac systems, security alerts may be displayed due to the absence of an EV code signing certificate for the FastTrack executable. These alerts can be safely ignored. To verify the FastTrack executable, you can easily and freely compare the MD5 checksum. For more detailed instructions, you can refer to the installation video.

Download​

Stable versions of FastTrack are released for Linux (official makeself, official AUR for ArchLinux), Mac (as app and homebrew), and Windows (installer, portable folder).

Installation​

  1. For Windows:
  2. For Linux (all distributions) as Makeself:
    • Download the Makeself archive FastTrack-x86_64.run.
    • Allow FastTrack.run to be executed:
      • Right-click on the run file.
      • Click on Properties.
      • Click on Permissions.
      • Tick “Allow executing file as program”.
  3. For Linux natively:
    • Arch Linux: yay -S fasttrack fasttrack-cli
    • From source : mkdir build ; cd build ; cmake ../ ; make ; sudo make install
  4. For Mac (.app):
    • Minimal version required based on Qt6 supported minimal version.
    • Download the FastTrack dmg FastTrack.dmg.
    • Double click on the dmg file.
    • Drag the application from the dmg window into the Applications folder.
  5. For Mac (brew):
    • Install https://brew.sh/.
    • brew tap fasttrackorg/fasttrack
    • brew install fasttrack
    • FastTrack-cli can be located at /usr/local/bin/FastTrack-Cli and directly used and FastTrack opened using open /usr/local/Cellar/fasttrack/6.3.1_1/bin/FastTrack.app.

macOS Troubleshooting for FastTrack Installation​

Follow these troubleshooting steps to ensure a seamless installation and optimal operation of FastTrack on macOS:

Application Authorization​

  • Unsigned Application Warning: If you encounter a message stating that "FastTrack" is damaged and can't be opened, it's because the application is not signed with a valid Apple Developer ID.

    • Solution:

      1. Open the Terminal application.

      2. Run the following command to remove the quarantine attribute:

        • For macOS 15 or higher:

          xattr -d com.apple.quarantine /Applications/FastTrack.app

        • For macOS 14 or lower:

          xattr -dr com.apple.quarantine /Applications/FastTrack.app

      3. Navigate to System Settings > Privacy and Security > Accessibility.

      4. If FastTrack is listed, ensure it is enabled.

      5. If you see an entry named fasttrack (without the capital 'F'), enable it as well. If not present:

        • Open Finder and go to /Applications/FastTrack.app/Contents/MacOS/.

        • Drag and drop the fasttrack binary into the Accessibility settings window.

        • Ensure both FastTrack and fasttrack are enabled.

    • Or use codesign --force --deep --sign - FastTrack.app

Update​

FastTrack will display a message at the start-up and in the status bar when a new release is available.

  1. For Windows:
    Search the FastTrackUpdater in the Windows Start Menu or execute the MaintenanceTool.exe in the installation folder directly and follow the provided instructions.

  2. For Linux:
    The FastTrack Makeself does not currently support the automatic update. Replace the current Makeself with the latest AppImage released.

  3. For Mac:

    • The FastTrack App does not currently support the automatic update. Replace the current App with the latest App released.
    • The brew package support upgrade using brew upgrade.