Decrediton Setup Guide¶
Last updated for v1.1.3.
Decrediton is a graphical user interface for
dcrwallet. When this application launches, it automatically starts its own instance of the command line tools
dcrwallet in the background.
Download and Install¶
The latest version of Decrediton can be downloaded from https://decred.org/downloads/. As of v1.1.3, Decrediton is available for Windows, macOS and Linux.
Download the Windows installer
Double click the installer and follow the instructions. This will install and automatically start up Decrediton to download the Decred blockchain and set up your wallet.
The installer adds a shortcut to Decrediton on your desktop for next time you want to use it.
Double click the
decrediton-v1.1.3.dmgfile once downloaded to mount the disk image.
Drag the decrediton.app into the link to your Applications folder within the disk image.
Navigate to download location and extract the .tar.gz file:
Ubuntu File Browser: simply right click on the .tar.gz file and select “Extract Here”.
Terminal: use the
tar -xvzf filename.tar.gzcommand.
Both of these should extract the tar.gz into a folder that shares the same name. (
e.g. tar -xvzf decrediton-v1.1.3.tar.gzshould extract to
decrediton-v1.1.3). If successful, this new folder should include a
During the creation process for your wallet, you will be given a sequence of 33 words known as a seed phrase. This seed phrase is essentially the private key for your wallet. You will be able to use this seed phrase to restore your private keys, transaction history, and balances using any Decred wallet on any computer.
This ultimately means that anyone who knows your seed can use it to restore your private keys, transaction history, and balances to a Decred wallet on their computer without your knowledge. For this reason, it is of utmost importance to keep your seed phrase safe. Treat this seed the same way you would treat a physical key to a safe. If you lose your seed phrase, you permanently lose access to your wallet and all funds within it. It cannot be recovered by anyone, including the Decred developers. It is recommended you write it down on paper and store that somewhere secure. If you decide to keep it on your computer, it would be best to keep it in an encrypted document (do not forget the password) in case the file or your computer is stolen.
REMINDER: DO NOT, UNDER ANY CIRCUMSTANCES, GIVE YOUR SEED OR THE ASSOCIATED HEX KEY TO ANYONE! NOT EVEN THE DEVELOPERS!
Open and Set Up Decrediton¶
Opening Decrediton for the first time will display the following screen:
To create a brand new Decred wallet, select Continue and follow the steps in the next section. A short presentation explaining Decred blockchain, wallet, keys, staking/governance, and safety tips is shown. Please read these slides carefully if you are new to Decred.
If you have used Decred before and wish to restore an existing wallet, skip this section and read Restore Existing Wallet From Seed
Create a New Wallet¶
Start by selecting Create a New Wallet which results in this screen:
The 33 word seed for your new wallet is displayed in the text box (obscured in the above image). Record the seed and store it somewhere safe. You will need to re-enter this seed on the next screen.
Confirm your seed by entering the words into the confirmation box.
Create a private passphrase for your wallet. This passphrase will be used to unlock your wallet when creating transactions.
Select Create Wallet. You should then see a spinning Decred logo. This will spin until
dcrdhas fully synced the blockchain.
On computers that haven’t had
dcrdloaded before, this should take 1-2 hours with newer hardware (it may take longer with older hardware). You can check your process monitor application for a running instance of
dcrd- if it is using a substantial percentage of your CPU, it is syncing. If it isn’t, Decrediton may require a restart to move beyond this screen.
When the whole blockchain has been scanned, Decrediton will open the Overview page displaying your current balance and recent transactions:
Restore Existing Wallet From Seed¶
If you already have a wallet seed you can use it by clicking on the Existing Seed button.
Enter your seed into the Confirm Seed text box.
Create a private passphrase for your wallet.
Select Create Wallet. Wait for the blockchain to be scanned.
Decrediton will not start!
dcrd closed due to an error. Check dcrd logs and contact support if the issue persists.
If you enocounter the above error, it could be because there is already a running instance of
dcrd on your machine. Decrediton attempts to start its own instance of
dcrwallet in the background.
You could possibly resolve this by killing any any running
dcrd processes prior to restarting Decrediton.
Where does Decrediton store data/write log files?
Decrediton stores the blockchain, your wallet, log files and its own configuration files all in a single directory. A different directory is used depending on the operating system:
|OS||Decrediton data directory|