Page tree
Skip to end of metadata
Go to start of metadata


Darkcoin is now Dash - guide is not rebranded yet ; )

As of v0.11.0, Darkcoin Core client offers KeePass integration. This guide will show you how to configure the association between Darkcoin and KeePass and how to save a Darkcoin wallet passphrase entry in KeePass through the integration. When this is done, KeePass can be used to unlock the wallet.

There is also a video (no sound) of this available here:

You will need the following:

The following keepass RPC commands are available in the Darkcoin client console or server:

  • keepass genkey: Generates a base64 encoded 256 bit AES key that can be used for the communication with KeePassHttp. This is only necessary for manual configuration. Use init for automatic configuration.
  • keepass init: Sets up the association between Darkcoin and KeePass by generating an AES key and sending an association message to KeePassHttp. This will trigger KeePass to ask for an Id for the association. Returns the association and the base64 encoded string for the AES key.
  • keepass setpassphrase : Updates the passphrase in KeePassHttp to a new value. This should match the passphrase you intend to use for the wallet. Please note that the standard RPC commands walletpassphrasechange and the wallet encrption from the QT GUI already send the updates to KeePassHttp, so this is only necessary for manual manipulation of the password.

The following new options are available for darkcoind and darkcoin-qt:

 Code (Text):

  1. -keepass               Use KeePass 2 integration using KeePassHttp plugin (default: 0)
  2. -keepassport=<port>    Connect to KeePassHttp on port <port> (default: 19455)
  3. -keepasskey=<key>      KeePassHttp key for AES encrypted communication with KeePass
  4. -keepassid=<name>      KeePassHttp id for the established association
  5. -keepassname=<name>    Name to construct url for KeePass entry that stores the wallet passphrase

keepass option is not necessary during configuration, but is necessary to retrieve the password from keepass.

Example scenario:
  • Existing encrypted wallet
  • current wallet passphrase: 1BWi2OXyk76uWumxJQy4
Step 1: Configure the association
  • Start KeePass2
  • Open existing database or create a new one:

  • Start the darkcoin-qt client
  • Open console: Help -> Debug Window -> Console:


  • Type: keepass init


  • KeePass will ask for a "Key name" for the association. Choose a relevant name, e.g.: testwalletassociation

Return to the darkcoin-qt console. The console will show the new key:

Edit your darkcoin.conf file with the information provided. You may freely choose a value for keepassname. This will be used to name the entry for the wallet passphrase in KeePass.


  • Code (Text):
    2. keepass=1
    3. keepasskey=MSb+JLygqz7ZH40SyJ1QR62iOOIXoa3tmT8SMGGI2K0=
    4. keepassid=testwalletassociation
    5. keepassname=testwallet


  • Close the darkcoin-qt client

Step 2: Setup wallet passphrase entry in the KeePass database

  • Make sure KeePass2 is running


  • Start the darkcoin-qt client


  • Open console: Help -> Debug Window -> Console:

Type: keepass setpassphrase <passphrase> (replace <passphrase> with your actual wallet passphrase):

A new entry should appear in KeePass with the name you specified in the keepassname configuration variable:


  • Save the KeePass2 database

At this point the configuration is complete. You set up the association and stored the wallet passphrase in KeePass2.

You can now use KeePass to manage and provide your wallet passphrase. To do this, simply use "keepass" (without the quotes) as passphrase when needed. The integration is active in the GUI (Unlock Wallet, Change Passphrase) as well as the RPC commands (walletpassphrase, walletpassphrasechange, masternode).

Small example for unlocking the wallet from the console:


  • No labels