Skip to content

Installation

smallketchup82 edited this page Nov 2, 2026 · 3 revisions

Install the prebuilt app unless you want to work on the port itself. For source builds, use Environment Setup.

Requirements

  • An Apple Silicon Mac; Intel Macs are not supported by these builds.
  • macOS 26 or newer, because the current renderer requires Metal 4.
  • Internet access to download the Zero-K game and maps, and for online play.
  • Steam installed and running only if you want Steam login.

You do not need developer tools, Mono, .NET, Wine, or Rosetta to run a prebuilt app. Homebrew is needed only for the optional Homebrew method below.

Download the DMG and install the app

  1. Open the latest ZkMacOS release and download Zero-K-macOS-arm64.dmg and (optionally) its .sha256 checksum file.
  2. Open the DMG and drag Zero-K onto Applications using the arrow.
  3. Eject the disk image and open Zero-K.app from Applications.
  4. Approve the app in macOS if needed, then sign in or choose offline play. The lobby downloads the game and required maps as needed; these are not included in the DMG.

(Optional) Place the checksum file beside the DMG and verify it in Terminal from that directory:

shasum -a 256 -c Zero-K-macOS-arm64.dmg.sha256

The release download is a DMG containing Zero-K.app. Install that app into Applications; do not run it from the mounted disk image. The repository’s Source code ZIP/tarball assets are for development.

Approve the downloaded app in macOS

The app is not Developer ID signed or notarized. Its ad-hoc signatures do not identify an Apple-verified publisher, so downloaded copies may be blocked. Only approve a copy whose source you trust.

After attempting to open it, use System Settings → Privacy & Security → Open Anyway if available. Alternatively, remove quarantine from that specific trusted copy:

xattr -dr com.apple.quarantine "/Applications/Zero-K.app"

See Apple’s app approval instructions for more detail.

First launch

A startup dialog explains that this client is unofficial and experimental. Choose I Understand to continue. You can use a normal Zero-K account or offline play; Steam is optional. For Steam login, start the regular Steam client and sign in before opening Zero-K.

Continue to Configuration, Updating and Uninstalling, or Troubleshooting.

Optional: Homebrew installation

Install Homebrew if you do not have it, then add this repository as a tap and install the cask:

brew tap smallketchup82/zkmacos https://github.com/smallketchup82/ZkMacOS.git
brew trust --cask smallketchup82/zkmacos/zkmacos
brew install --cask smallketchup82/zkmacos/zkmacos

The trust command authorizes this third-party cask specifically. Review this repository before granting trust. If your older Homebrew version does not provide brew trust, omit that line.

Open Zero-K.app from Applications and follow the macOS approval instructions above if needed. If you already installed manually, move the old app out of Applications first so Homebrew can manage its own copy. Keep your Application Support folder.

See Homebrew tap trust for how third-party cask trust works.

Clone this wiki locally