Development Setup on macOS

The following instructions will guide you from a clean installation of macOS to a working source checkout of raiden.

  1. Install C/C++ compiler infrastructure:

    $ xcode-select --install
    • Click “Install” then “Agree”, wait for installation to complete
  2. Install Homebrew (a macOS package manager):

    $ /usr/bin/ruby -e "$(curl -fsSL"
    • Follow the instructions
  3. Install system packages needed for raiden and its dependencies:

    $ brew install automake gmp leveldb libffi libtool openssl pkg-config
  4. Install pip (a Python package manager):

    $ sudo easy_install pip
  5. Install virtualenv:

    $ sudo pip install virtualenv
  6. Create a virtualenv for raiden (requires python3.7):

    $ virtualenv --python=python3.7 venv-raiden
  7. “Activate” the virtualenv:

    $ source venv-raiden/bin/activate
  8. Clone the raiden repository:

    $ git clone
  9. Install the dependencies and make raiden available inside the virtualenv:

    $ cd raiden
    $ make install-dev
    # or alternatively, manually:
    # pip install -c constraints-dev.txt -r requirements-dev.txt -e .

Now you have a working source installation of Raiden. To actually use it you also need the solidity compiler solc and an Ethereum client. Both can be installed as follows:

$ brew tap ethereum/ethereum
$ brew install solidity ethereum

The installation should now be complete. To ensure your setup is working correctly you can use the smoketest command:

$ raiden smoketest

Return to the installation guide