Skip to content

Manual CLI Installation

Last updated for CLI release v1.8.0.


The newest binary releases can be found here. With the exception of the .exe, .AppImage and .dmg files, they are archives of the latest executable binaries for each release. Although most of this will be extract and go, instructions are provided for Windows, macOS, and Linux below.

  1. Download the correct file for your computer:

    Architecture Filename
    32-bit decred-windows-386-v1.8.0.zip
    64-bit decred-windows-amd64-v1.8.0.zip
  2. For your security, verify that your download hash matches the hash in the Decred releases manifest. For detailed instructions, read about Verifying Binaries.

  3. Navigate to download location and extract the .zip file:

    Right click on the .zip file, select “Extract All…” and a prompt should open asking for the directory to use. The default will extract the .zip to a folder with the same name.

  1. Download the correct file for your computer:

    Architecture Filename
    Intel decred-darwin-amd64-v1.8.0.tar.gz
    Apple Silicon decred-darwin-arm64-v1.8.0.tar.gz
  2. For your security, verify that your download hash matches the hash in the Decred releases manifest. For detailed instructions, read about Verifying Binaries.

  3. Navigate to download location and extract the .tar.gz file:

    Finder: simply double click on the .tar.gz file.

    Terminal: use the tar -xvzf filename.tar.gz command.

    Both of these should extract the .tar.gz file into a folder that shares the same name. (e.g. tar -xvzf decred-darwin-amd64-v1.8.0.tar.gz should extract to decred-darwin-amd64-v1.8.0).

  1. Download the correct file for your computer:

    Architecture Filename
    32-bit decred-linux-386-v1.8.0.tar.gz
    64-bit decred-linux-amd64-v1.8.0.tar.gz
    32-bit ARM decred-linux-arm-v1.8.0.tar.gz
    64-bit ARM decred-linux-arm64-v1.8.0.tar.gz
  2. For your security, verify that your download hash matches the hash in the Decred releases manifest. For detailed instructions, read about Verifying Binaries.

  3. 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.gz command.

    Both of these should extract the .tar.gz file into a folder that shares the same name. (e.g. tar -xvzf decred-linux-amd64-v1.8.0.tar.gz should extract to decred-linux-amd64-v1.8.0).

  1. Download the correct file for your computer:

    Architecture Filename
    FreeBSD amd64 decred-freebsd-amd64-v1.8.0.tar.gz
    OpenBSD amd64 decred-openbsd-amd64-v1.8.0.tar.gz
  2. For your security, verify that your download hash matches the hash in the Decred releases manifest. For detailed instructions, read about Verifying Binaries.

  3. Navigate to download location and extract the .tar.gz file:

    Terminal: use the tar -xvzf filename.tar.gz command.

    The .tar.gz file will be extracted into a folder that shares the same name. (e.g. tar -xvzf decred-openbsd-amd64-v1.8.0.tar.gz should extract to decred-openbsd-amd64-v1.8.0).


Minimum Configuration

At the very minimum, for dcrd, dcrwallet, and dcrctl to be able to communicate with each other, they need to be launched with the same rpcuser/rpcpass combination. For manual configuration please follow these steps:

  1. If the OS-specific home directories listed in Configuration File Locations do not exist, please create them for dcrd, dcrwallet, and dcrctl.

  2. Choose an arbitrary username and password, these will only be used for each application to communicate via remote procedure call. The easiest configuration is to set them all equal.

  3. Using your favorite text editor, create a new text file and add the following lines:

    [Application Options]
    rpcuser=<chosen-username>
    rpcpass=<chosen-password>
    

    Save it as dcrd.conf in dcrd’s home directory.

  4. Create another new text file and add the following lines:

    [Application Options]
    username=<chosen-username>
    password=<chosen-password>
    

    Save it as dcrwallet.conf in dcrwallet’s home directory.

  5. Create a third text file and add the following lines:

    [Application Options]
    rpcuser=<chosen-username>
    rpcpass=<chosen-password>
    

    Save it as dcrctl.conf in dcrctl’s home directory.


Additional Configuration Options

All command line options can be put in the config file. The sample config files in the release package give additional options or you can run one of the programs with the -h flag to show a list and description of all options for the specified application.

There is also a full list of options for each application which can be found here.