Cross platform GUI for decred
JavaScript CSS Protocol Buffer HTML
Latest commit 833ac8a Jan 16, 2017 @jcvernaleo jcvernaleo committed with alexlyp Simplify grpc build instructions. (#171)
Since electron support went into grpc we no longer need
to use a special branch or build instructions.

Until there is a new GRPC release local building is still necessary.

Closes #170


decrediton is a cross-platform GUI for decred written in node.js using Electron.


Currently decrediton has only been tested and built on Linux and macOS. Additional systems will be added in the future.

Decrediton will NOT use or in any way disrupt the wallet file you may already be using at this time.

Download the decrediton release for your operating system.

On macOS, Ubuntu (14.04 and later), and recent Debians, there should be no additional dependencies needed.

On Fedora or similar distros you may need to install the libXScrnSaver package if you see this error:

error while loading shared libraries:

You can install this on a recent Fedora with the command:

sudo dnf -y install libXScrnSaver

On linux you will need to decompress the package:

tar -xvzf decrediton-X.X.X.tar.gz

and then run the file:


This will start dcrd and dcrwallet for you.

On macOS, double-click the .dmg file, drag the .app to your Applications folder. Double click on to start.

From there follow the on screen instructions to setup your wallet.


Due to potential compatibility issues, for now, all work should be done with node v6.5.0 and electron 1.4.6. It is likely we can relax this once things have settled down. The recommended way to install node is using nvm.

This has primarily been tested on Linux at the moment although OSX should work similarly.

git clone ~/.nvm && cd ~/.nvm && git checkout `git describe --abbrev=0 --tags`
. ~/.nvm/
nvm install v6.5.0
nvm use v6.5.0
nvm alias default v6.5.0
npm install -g npm

Due to an incompatibility between grpc and electron, several extra steps are necessary. As some current PRs make it into grpc these steps will be unnecessary in the future. Since you must locally build grpc, you must have compilers and the normal development tools installed.

Adjust the following steps for the paths you want to use.

mkdir code
cd code
git clone
git clone
cd grpc
git submodule update --init
npm install
cd ../decrediton
npm install

Start dcrd and dcrwallet with the following options. Note, you must NOT already have rpc certs from dcrwallet so it is easiest to start with an emtpy $HOME/.dcrwallet

dcrd --testnet -u USER -P PASSWORD --rpclisten= --rpccert=$HOME/.dcrd/rpc.cert
dcrwallet --testnet --experimentalrpclisten= --noinitialload --tlscurve=P-256 --onetimetlskey --appdata=~/.config/decrediton

On macOS you should use:

dcrd --testnet -u USER -P PASSWORD --rpclisten= --rpccert=$HOME/Library/Application\ Support\Dcrd/rpc.cert
dcrwallet --testnet --experimentalrpclisten= --noinitialload --tlscurve=P-256 --onetimetlskey --appdata=$HOME/Library/Application\ Support/decrediton

Start decrediton

npm run dev

Building the package

To build a packaged version of decrediton (including a dmg on OSX and exe on Windows), follow the development steps above. Then build the dcr command line tools:

go get -u -v
go get -u -v
go get -u -v
glide i
go install . ./cmd/dcrctl/
cd ../dcrwallet
glide i
go install
cd code/decrediton
mkdir bin
cp `which dcrd` bin/
cp `which dcrctl` bin/
cp `which dcrwallet` bin/
npm install
npm run package


If you have any further questions you can find us at:

  • (channel #decred)
  • webchat

Issue Tracker

The integrated github issue tracker is used for this project.


decrediton is licensed under the copyfree ISC License.