Skip to content

Guides

How to notarise macOS apps in CI

Notarisation is slow and occasionally times out.

5 min read

Notarisation is slow and occasionally times out.

Why it happens

It is a network round-trip to Apple that can take several minutes and is outside your control.

How to fix it

  1. Use notarytool with an App Store Connect API key rather than an Apple ID
  2. Run notarisation in its own job so it does not block test feedback
  3. Staple the ticket after notarisation completes
  4. Set a generous timeout — Apple's turnaround varies

Your next build could be twice as fast, at half the price

Start free. Migrating away is the same one line, and we publish that diff too.