Installing CKAN on macOS

Why is this page popping up?

If this page popped up after launching CKAN, you are missing Mono! Follow the link in step 1 below to install it.

Compatibility

Note that Apple's "M1" systems use the ARM architecture, which Mono only supports for Linux, not Mac OS. If you have such a system, it won't be able to run Mono, which means it also won't be able to run CKAN.

Installing manually

1. Download and install Mono

2. Download CKAN.dmg from https://github.com/KSP-CKAN/CKAN/releases/latest

3. Open it

4. Drag CKAN.app to your desktop (or any other folder you prefer)

5. Double click it

6. If a permission request similar to "bash" wants access to control "Terminal" pops up, press "OK"

If you are on macOS Catalina, you'll notice that CKAN's Console UI opens in a terminal, instead of the GUI. This is because macOS dropped support for 32-bit applications with version 10.15, and Mono's WinForms implementation is 32-bit only. For more information, check this PR and this issue.

Installing via Homebrew

Sonoma has some reported instabilities, and Sequoia works just fine; this also reportedly worked as far back as Mojave:

$ brew update
$ brew install mono
$ brew install ckan
$ ckan consoleui

Installed versions are:

ckan 1.34.4
mono 6.12.0

Using Console UI

If you are on macOS 10.15 or later, see the user guide for help with using the Terminal-based UI.