Getting Started: macOS

See also Getting Started.

Prerequisites

You will need Xcode, available through the App store, and the command-line developer tools

xcode-select --install

The MacPorts project has good instructions for setting up a development environment on MacOS.

The installer requires Python 3, CMake, and a C++ compiler. Also, the distribution is packaged using GNU tar.

brew install cmake gnu-tar

Optional prerequisites

For a full system you will need to install X11. Using Homebrew:

brew install xquartz libxaw libxft

Headless install

The default install doesn't try to build the UI libraries.

N.B., AMD64_LINUX is not a misprint. The systems are similar enough that the 64-bit Linux distribution can be used to install on MacOS, so there is no separate MacOS download.

wget https://github.com/modula3/cm3/releases/download/d5.11.4/cm3-dist-AMD64_LINUX-d5.11.4.tar.xz
gtar Jxf cm3-dist-AMD64_LINUX-d5.11.4.tar.xz
mkdir build
cd build
../cm3-dist-AMD64_LINUX-d5.11.4/scripts/concierge.py install --prefix $HOME/cm3
PATH=$HOME/cm3/bin:$PATH

Full install

Specify "all" to build the UI libraries.

wget https://github.com/modula3/cm3/releases/download/d5.11.4/cm3-dist-AMD64_LINUX-d5.11.4.tar.xz
gtar Jxf cm3-dist-AMD64_LINUX-d5.11.4.tar.xz
mkdir build
cd build
../cm3-dist-AMD64_LINUX-d5.11.4/scripts/concierge.py install --prefix $HOME/cm3 all
PATH=$HOME/cm3/bin:$PATH