Skip to content

macOS Installation

Dan Ravensloft edited this page May 25, 2019 · 11 revisions

This article is a stub.

Pre-built package

Download the latest .dmg file from Releases, double-click and follow the instructions.

Only download the -legacy one if you are running OSX 10.10 or earlier.

NOTE: we are looking for maintainers to support Homebrew, MacPorts etc. Open an issue if you are willing to help.

Build from source

Install the latest version of Xcode from the App Store. Then open a terminal and execute xcode-select --install to install Command Line Tools. Then open Xcode, accept the license agreement and wait for it to install any additional components. After you finally see the "Welcome to Xcode" screen, from the top bar choose Xcode -> Preferences -> Locations -> Command Line Tools and select an SDK version.

Install Homebrew and the dependencies:

brew install cmake qt5 quazip

NOTE: If Qt is not found, you might need to temporarily add it to PATH.

Semi-automatic installation

Install git, clone the repository, execute quickinstall and follow the instructions:

git clone
cd ckb-next

Manual installation

Install git and clone the repository:

git clone
cd ckb-next

NOTE: git is the preferred way to obtain the source code, because it is used to obtain the version for the binary.

ckb-next uses CMake during the build process. See CMake Options for the list of available switches.

Generate the desired configuration with CMake, compile and install:

cmake --build build --target all -- -j
sudo cmake --build build --target install


If you were using a pre-built package of ckb-next or ckb (any version):

killall -KILL ckb
killall -KILL ckb-next
sudo launchctl unload -w /Library/LaunchDaemons/org.ckb.daemon.plist
sudo launchctl unload -w /Library/LaunchDaemons/org.ckb-next.daemon.plist
sudo rm -rf /Applications/
sudo rm -rf /Applications/
sudo rm -rf /Library/LaunchDaemons/org.ckb.daemon.plist
sudo rm -rf /Library/LaunchDaemons/org.ckb-next.daemon.plist
sudo rm -rf /Library/Application\ Support/ckb-next-daemon

Some may return errors, but that should be expected.

Otherwise, ckb-next provides uninstall target, but it's a bit tricky. You should recall all -DOPTION=VALUE flags you have used when generating the configuration for installation, build install target and then build uninstall target. For example:

cmake --build build --target all -- -j
sudo cmake --build build --target install
sudo cmake --build build --target uninstall

The compilation and installation steps are required because install target generates an install manifest that later allows to determine which files to remove and what is their location.

NOTE: this method works only with ckb-next >=0.3.0.

NOTE: this method is the preferred and supported way to remove ckb-next.

NOTE: this method will not remove any of the files belonging to ckb-next <=0.2.9 or ckb <=0.2.7 if they are not overlapping with ckb-next >=0.3.0. It will only ensure it is safe to remove any ckb-related files, whatever the version would be, and only remove ckb-next >=0.3.0 components.

If you have been using ckb-next <=0.2.9 (with old ckb and ckb-daemon binaries) or even ckb <=0.2.7 (by ccMSC), you will have to remove files manually. The example of removal for pre-built packages above is also suitable for removal after manual compilation. It is possible to encounter some leftovers, those commands are not panacea.

You can’t perform that action at this time.