Skip to main content

Installation

Octatrack Manager is a cross-platform desktop application available for Windows, macOS, and Linux.

Download​

Always download the latest version from the official GitHub Releases page:

Choose the file that matches your operating system below.

macOS​

Important Note for Mac Users

Octatrack Manager is not signed with an Apple Developer certificate. macOS will block the first launch, and you need to approve the app manually — a one-time step described below.

  1. Download: Get the .dmg file for your Mac:

  2. Install: Open the .dmg file and drag Octatrack Manager into your Applications folder.

  3. Approve the app (first launch only):

    • Open your Applications folder and double-click Octatrack Manager.
    • macOS shows a warning that it could not verify the app. Click Done (not "Move to Trash").
    • Open System Settings → Privacy & Security, scroll down to the Security section, and click Open Anyway next to the message about Octatrack Manager.
    • Confirm Open Anyway in the dialog that appears. The app will open normally from now on.

    On macOS 14 (Sonoma) and earlier, you can instead right-click Octatrack Manager in Applications, select Open, and click Open in the warning dialog.

    If the app still refuses to open: Open the Terminal app and paste this command, then press Enter:

    xattr -cr /Applications/octatrack-manager.app

    This command removes the "quarantine" attribute macOS places on downloaded files.

Windows​

  1. Download: Get the installer for Windows: Download .msi (recommended) or Download .exe.
  2. Install: Double-click the file and follow the setup wizard instructions.
  3. Launch: Open Octatrack Manager from your Start menu or Desktop shortcut.

Linux​

We provide three package formats for Linux users:

  • Debian / Ubuntu: Download .deb and install it:

    sudo apt install octatrack-manager_*.deb

  • Fedora / RHEL: Download .rpm and install it:

    sudo dnf install octatrack-manager-*.rpm

  • AppImage (Universal): Download .AppImage, make it executable, and run it:

    chmod +x octatrack-manager_*.AppImage
    ./octatrack-manager_*.AppImage

Verifying Installation​

Launch the application. You should see the Home screen with a Scan for Projects button. If the application starts successfully, you are ready to proceed to the Quick Start guide.

Updating​

The app includes an automatic update checker. When a new version is available, you will see a notification in the app header. Click the version number Version badge to manually check and download the latest version.

To update manually, simply download the latest installer for your platform and run it. It will automatically replace the old version while keeping your settings intact.