System Requirements and Installation Guide


Raiden is a payment channel implementation which provides scalable, low latency, and cheap token transfers for Ethereum.



If you are just switching from an old installation of raiden which was using python 2, then you should make sure to remove your raiden directory. By default that would mean: rm -rf ~/.raiden

The preferred way to install Raiden is downloading a self contained application bundle from the GitHub release page.


Download the latest raiden-<version>-linux.tar.gz, and extract it:

tar -xvzf raiden-<version>-linux.tar.gz

The Raiden binary should work on most 64bit GNU/Linux distributions without any specific system dependencies, other than an Ethereum client installed in your system (see below). The Raiden binary takes the same command line arguments as the raiden script.


Download the latest raiden-<version>, and extract it:

unzip raiden-<version>

The resulting binary will work on any version of macOS from 10.12 onwards without any other dependencies. An Ethereum client is required.


You will need to have an Ethereum client installed in your system.

Now you are ready to get started.

For developers

If you plan to develop on the Raiden source code, or the binary distributions do not work for your system, you can follow these steps to install a development version.


Additional dependencies for development installations

  • You need to make sure that your system has solc, the ethereum solidity compiler installed.

Refer to its documentation for the installation steps. - You will also need to obtain the system dependencies for pyethapp.

Installation from source

Clone the repository:

git clone

Navigate to the directory:

cd raiden

It’s advised to create a virtualenv for Raiden and install all python dependencies there.

After you have done that you can proceed to install the dependencies:

pip install --upgrade -r requirements-dev.txt
python develop

You will also need to connect your Ethereum client to the Ropsten testnet. See below for guidelines on how to connect with both Parity and Geth.


Please refer to the detailed step-by-step guide for setting up a macOS development environment.

Firing it up

Using geth

Run the Ethereum client and let it sync with the Ropsten testnet:

geth --testnet --fast --rpc --rpcapi eth,net,web3 --bootnodes "enode://20c9ad97c081d63397d7b685a412227a40e23c8bdc6688c6f37e97cfbc22d2b4d1db1510d8f61e6a8866ad7f0e17c02b14182d37ea7c3c8b9c2683aeb6b733a1@,enode://6ce05930c72abc632c58e2e4324f7c7ea478cec0ed4fa2528982cf34483094e9cbc9216e7aa349691242576d552a2a56aaeae426c5303ded677ce455ba1acd9d@"

Unless you already have an account you can also create one in the console by invoking personal.newAccount().

If problems arise for above method, please see the Ropsten README for further instructions.

Then launch Raiden with the default testnet keystore path:

raiden --keystore-path  ~/.ethereum/testnet/keystore

Using parity

Run the client and let it sync with the Ropsten testnet:

parity --chain ropsten --bootnodes "enode://20c9ad97c081d63397d7b685a412227a40e23c8bdc6688c6f37e97cfbc22d2b4d1db1510d8f61e6a8866ad7f0e17c02b14182d37ea7c3c8b9c2683aeb6b733a1@,enode://6ce05930c72abc632c58e2e4324f7c7ea478cec0ed4fa2528982cf34483094e9cbc9216e7aa349691242576d552a2a56aaeae426c5303ded677ce455ba1acd9d@"

After syncing the chain, create an account on the Ropsten testnet by navigating to the url that parity shows. It is usually:

After account creation, launch Raiden with the path of your keystore supplied:

raiden --keystore-path ~/.local/share/io.parity.ethereum/keys/test

Select the Ethereum account when prompted, and type in the account’s password.

See the API walkthrough for further instructions on how to interact with Raiden.