Running Godot apps on macOS

    This page covers running Godot projects on macOS. If you haven’t exported your project yet, read Exporting for macOS first.

    By default, macOS will run only applications that are signed and notarized.

    Depending on the way a macOS app is signed and distributed, the following scenarios are possible:

    Note

    App developers need to join the Apple Developer Program, and configure signing and notarization options during export, then upload the app to the App Store.

    The app should run out of the box, without extra user interaction required.

    Note

    App developers need to join the Apple Developer Program, and configure signing and notarization options during export, then distribute the app as “.DMG” or “.ZIP” archive.

    When you run the app for the first time, the following dialog is displayed:

    Click to start the app.

    If you see the following warning dialog, your Mac is set up to allow apps only from the App Store.

    ../../_images/signed_and_notarized_1.png

    To allow third-party apps, open System Preferences, click Security & Privacy, then click General, unlock settings, and select App Store and identified developers.

    App developer used self-signed certificate or ad-hoc signing (default Godot behavior for exported project).

    When you run the app for the first time, the following dialog is displayed:

    ../../_images/signed_0.png

    To run this app, you can temporarily override Gatekeeper:

    • Either open System Preferences, click Security & Privacy, then click General, and click Open Anyway.

    • Or, right-click (Control-click) on the app icon in the Finder window and select from the menu.

      ../../_images/signed_1.png

    • Then click Open in the confirmation dialog.

    • Enter your password if you’re prompted.

    Note

    App is built using official export templates, but it is not signed.

    When you run the app for the first time, the following dialog is displayed:

    ../../_images/linker_signed_1.png

    To run this app, you should remove the quarantine extended file attribute manually:

    • Navigate to the folder containing the target application.

      Use the cd path_to_the_app_folder command, e.g. cd ~/Downloads/ if it’s in the Downloads folder.

    • Run the command xattr -dr com.apple.quarantine "Unsigned Game.app" (including quotation marks and extension).

    Note

    App is built using custom export templates, compiled using OSXCross, and it is not signed at all.

    When you run the app for the first time, the following dialog is displayed:

    To run this app, you can ad-hoc sign it yourself:

    • Install Xcode for the App Store, start it and confirm command line tools installation.

    • Open Terminal.app (press Cmd + Space, and enter Terminal).

    • Run the following commands:

      xattr -dr com.apple.quarantine "Unsigned Game.app" (including quotation marks and “.app” extension).

      (including quotation marks and “.app” extension).