Building Monal

Software needed to build Monal:

• CocoaPods (see below)
• Xcode (only runs on macOS, see below if you don't own a Mac)
• git

Build steps:

1. clone repo

git clone https://github.com/monal-im/Monal.git Monal-IM
cd Monal-IM

2. init and update submodules (localizations)

git submodule update --remote --init

3. install dependencies

cd Monal
pod install

4. open in Xcode and build

open Monal.xcworkspace

Read here how to use logging with the Monal UDP Logger to debug things.

Developing without Mac

If you are interested in building Monal but don't have a Mac you can virtualize:

• MacOS Bis Sur (current buildserver)
• MacOS Catalina (used for old buildserver)
• Alternative 1
• Alternative 2
• Alternative 3
• Mac OS Beta ISO as well as the free preview image

Direct download links to all XCode versions If you want to connect your physical iPhone to XCode inside your VM, use this (tested by Monal devs)

Alpha builds (bleeding edge)

If you want to live on the edge and use all new bleeding-edge features that just got implemented, you can use the alpha builds of Monal, too. Just sent the UDID of your device (the serial number visible via lsusb on a Linux system) to [email protected]. Once your device has been added, you can download and install the build. For each new commit to the develop branch a new build will go down the pipeline.

Please be reminded that the alpha builds obviously might be unstable, slower or come with other severe issues.

Read here how to use logging with the Monal UDP Logger to debug things.

Installing Cocoapods

You'll need to use homebrew to install cocoapods, other ways to install cocoapods may result in strange errors.

Step #1: Install Homebrew

Go to https://brew.sh/ and follow the instructions to install homebrew.
Don't forget to follow the "next steps" printed to your terminal once homebrew finishes.

Step #2: Install Cocoapods via Homebrew

In the terminal type brew install cocoapods

Done.