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:

Download Octatrack Manager

Choose the file that matches your operating system below.

macOS​

Important Note for Mac Users

Octatrack Manager is not yet "signed" with an Apple Developer certificate. This means macOS will block it by default unless you follow these specific steps.

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

    • Intel Macs: Look for _x64_darwin.dmg
    • Apple Silicon (M1/M2/M3): Look for _aarch64_darwin.dmg

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

  3. Bypass Gatekeeper:

    • Open your Applications folder in Finder.
    • Right-click (or Control-click) on Octatrack Manager.
    • Select Open from the menu.
    • A dialog will appear warning you about the unidentified developer. Click Open again.

    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 that prevents the app from launching.

Windows​

  1. Download: Get the installer file ending in .msi (recommended) or .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 the .deb file and install it:

    sudo dpkg -i octatrack-manager_*.deb

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

    sudo rpm -i octatrack-manager-*.rpm

  • AppImage (Universal): Download the .AppImage file, 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.

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.