System Requirements and Installation Guide¶
Raiden is a payment channel implementation which provides scalable, low latency, and cheap token transfers for Ethereum.
The preferred way to install Raiden is downloading a self contained application bundle from the GitHub release page.
Download the latest
raiden--x86_64.AppImage, and make it executable:
chmod +x raiden–x86_64.AppImage
The Raiden AppImage 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 AppImage bundle takes the same command line arguments as the
Download the latest
raiden-<version>-macOS.zip, and extract it:
The resulting binary will work on any version of macOS from 10.12 onwards without any other dependencies. An Ethereum client is required.
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.
Installation from source¶
Clone the repository:
Navigate to the directory:
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 setup.py 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.
Firing it up¶
Run the Ethereum client and let it sync with the Ropsten testnet:
geth --testnet --fast --rpc --rpcapi eth,net,web3 --bootnodes "enode://firstname.lastname@example.org:30303,enode://email@example.com:30303"
Unless you already have an account you can also create one in the console by invoking
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
Run the client and let it sync with the Ropsten testnet:
parity --chain ropsten --bootnodes "enode://firstname.lastname@example.org:30303,enode://email@example.com:30303"
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.