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 https://raw.githubusercontent.com/Homebrew/install/master/install)"
    
    • 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 https://github.com/raiden-network/raiden.git
    
  9. Install the dependecies:

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

    $ python setup.py 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