UmbracomacOS installationAll documentation

macOS · Apple Silicon and Intel

Install and pair the native Mac app

Choose Apple Silicon for M-series Macs or Intel for Intel-based Macs. The DMG bundles the app, worker, pairing flow, and launchd recovery; Python and Homebrew are not required.

Install

  1. Sign in to the owner control centre, open Add a computer, and create a pairing file.
  2. Download macOS · Apple Silicon or macOS · Intel.
  3. Open the DMG and drag Umbraco to Applications.
  4. Open Umbraco, select the pairing file and a dedicated project folder, then choose Pair and start.
  5. Choose Open remote work to review and approve command and application access.
  6. Confirm the computer appears online in the control centre.

Developer-build limitation

These packages are tested native developer builds but are not yet signed or notarized with an Apple Developer ID. If macOS blocks the app, stop and use a signed release when available. Do not disable Gatekeeper or weaken system security.

Sleep and sign-in behavior

The worker recovers through launchd after sign-in. It cannot receive work while the Mac is asleep or signed out. Wake-on-LAN additionally depends on Mac hardware support and correctly configured local networking, router forwarding, and public IPv4 reachability.