answers.delivery

How-to · 3 min read

How to sign and notarize a Mac app outside the App Store

You sell your Mac app as a direct download, and every release ends with the same pile of Terminal commands to sign, notarize and staple it. Miss one flag and customers get a Gatekeeper warning instead of your app. You copy the commands from an old note, wait for Apple, check the result and hope you stapled the right file. It works, but it is slow, easy to get wrong and hard to hand to anyone else.

Published
17 Nov 2026
Delivery
No. 12
Topic
Developer
Evidence
9 claims quoted from dmgkit.app

01
Why it's hard

Apple's trust chain for apps outside the Mac App Store has several separate steps. The app bundle needs a Developer ID Application signature with Hardened Runtime, the disk image often needs its own signature, the build goes to Apple's notary service, and the ticket then has to be stapled so it works offline. Each step has its own tool and its own error messages, and the logs are long. Order matters too: notarize the wrong file or package before stapling and you start over. Most developers do this a few times a year, so the details never stick. And if a contractor or teammate needs to cut a release while you are away, there is rarely a written process they can follow.

This part describes the usual way. It makes no claims about DMGKit, so nothing is quoted here.

02
How DMGKit does it

DMGKit is a Mac app that keeps signing, notarization and stapling tied to the release you are building. You set up your Developer ID identities once, store a notarytool keychain profile name, and each export signs, notarizes and staples in one flow. A built-in Inspector then opens the finished DMG or package and gives you a trust score with signature, Team ID, Hardened Runtime, notarization and Gatekeeper checks, so you see what customers will see before you upload. If you prefer the command line, the free CLIKit does the same job with one command and uses the same engine. Because the identities and profile are saved, the next release is the same few clicks, not another evening of copying commands from old notes.

Signing, notarization, stapling and export settings in a single release flow.Quoted from dmgkit.app
Notarytool keychain profile. Store the profile name once; DMGKit copies the Terminal command you need to create it.Quoted from dmgkit.app
Open any DMG or package and get a trust score with every check grouped and explained.Quoted from dmgkit.app

03
Step by step

  1. 1Pick your Developer ID Application identity, and the Developer ID Installer one if you ship a .pkg.
  2. 2Enter your notarytool keychain profile name and run the Terminal command DMGKit copies for you once.
  3. 3Choose the app bundle, the DMG or PKG format and the compression.
  4. 4Export, and let DMGKit sign, notarize and staple in a single run.
  5. 5Open the result in the Inspector and check the Gatekeeper and notarization sections.
  6. 6Upload the DMG, together with the Sparkle appcast if you use one.

04
Tips

Use an App Store Connect API key if you notarize from more than one Mac or from CI. Both DMGKit and CLIKit accept one.

App Store Connect API keyQuoted from dmgkit.app

Move the routine release to CLIKit once the setup works. One command builds, signs, notarizes and staples, and it returns JSON and exit codes a CI job can read.

One command. clikit start builds, signs, notarizes and staples a release.Quoted from dmgkit.app

When a step fails, ask Kit before reading the raw log. It runs on your Mac and explains why a step failed and what to check next.

Find out why a step failed and what to check next.Quoted from dmgkit.app

Download your own release from the public link on a second Mac before announcing it. A file that passes locally can still trip Gatekeeper once the quarantine flag is added by the browser, and testing the real download catches that before your customers do.

General advice. Not a claim about the product.

05
Questions

Can it notarize a DMG I already built elsewhere?

Yes. It can notarize an existing DMG or PKG, so you can use it on files from your current build script.

Notarizes an existing DMG or PKGQuoted from dmgkit.app

Which macOS version does it need?

DMGKit needs macOS 15 or later, and CLIKit needs macOS 14.6 or later.

Minimum macOS macOS 15 macOS 14.6Quoted from dmgkit.app

Is it a subscription?

No. DMGKit is a one-time purchase of $24.99, and CLIKit and the Inspector are free.

DMGKit is a one-time purchase. CLIKit and DMGKit Inspector are free.Quoted from dmgkit.app

More from DMGKit

All 2 answers