Mac OS Installation

    Install via Homebrew

    Once you have the Homebrew package manager itself installed, you can install the latest Headlamp release by running the following command:

    brew install --cask headlamp


    To upgrade Headlamp when it’s installed via Homebrew, run:

    brew upgrade headlamp

    For more information on upgrading packages with Homebrew, including automatic updates, please read the official documentation .

    Install via Github Releases

    For Mac OS we provide a .dmg file, so you need to download it from the releases page and then follow the below steps :

    1. Double click the downloaded file to make its content available (name will show up in the Finder sidebar), usually a window opens showing the content as well
    2. Drag the application from the DMG window into /Applications to install wait for the copy process to finish.

    Once the installation process is completed you can find Headlamp as a desktop app in Applications directory.


    Until we have an automatic update, to upgrade Headlamp when it’s installed directly via the releases page, you have to download any newer version and re-install it.