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.6):

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

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

    $ git clone
  9. Install the dependecies:

    $ cd raiden
    $ pip install -c constraints.txt -r requirements-dev.txt
  10. Make raiden available inside the virtualenv:

    $ python develop

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