Repository navigation
Updating and Uninstalling
ZkMacOS checks for stable releases in the background and provides an update window to download, verify, and install them. Choose Zero-K → Check for Updates… in the application menu, or toggle Zero-K → Check Automatically. Automatic checks are enabled by default; unattended installation is off by default. Update checks follow a specific schedule rather than running on every launch.
If an update is ready while you are playing, finish your match and quit Zero-K normally. Installation and relaunch wait until the helper and engine exit; the updater does not forcibly stop a match.
Sometimes, you might need to update manually, say if a release pushes a faulty auto updater. In such a scenario, finish any ongoing games and quit Zero-K completely. Download the new DMG from Releases, then replace the old app in Applications with the new one. Installation covers checksum verification and macOS approval instructions.
Your user data is located separately from the Zero-K.app file, so it will remain safe during a manual update. The newly downloaded app version may show its first-launch warning again; this does not mean your settings were erased, this is intended.
If Homebrew manages your copy, quit Zero-K before running:
brew update
brew upgrade --cask smallketchup82/zkmacos/zkmacosThe cask is marked auto_updates true. Sparkle can update the app too, but it does not update Homebrew’s receipt; an explicit Homebrew upgrade may reinstall a version Sparkle already installed. Let an active update finish before switching update methods. Do not run a Homebrew upgrade during a game.
For a manual installation, quit Zero-K and move Zero-K.app from Applications to Trash. For a Homebrew installation:
brew uninstall --cask smallketchup82/zkmacos/zkmacosBoth leave your settings, downloads, saves and replays in Application Support. Keep that folder if you may return to the game. Removing it yourself also removes those files; back it up first.
ZkMacOS source · Download the DMG · Report a bug · Get help
Unofficial, experimental Zero-K client. These guides describe the current source; older releases may differ.
- Getting Started
- Playing Zero-K
- Development
- Contributing
- Environment Setup
- Build and Release
- Internals and Validation
- Licensing and Credits
- Source · Downloads