Skip to content
Switch branches/tags


Failed to load latest commit information.
Latest commit message
Commit time
Document maintainer: Nikola Glumac
Document status: Active


Build status Release

Daedalus - Cryptocurrency Wallet



Yarn is required to install npm dependencies to build Daedalus.


Nix is needed to run Daedalus in nix-shell.

  1. Install nix: curl -L | sh (use sh <(curl -L --darwin-use-unencrypted-nix-store-volume on macOS Catalina)

  2. Employ the signed IOHK binary cache:

    $ sudo mkdir -p /etc/nix
    $ sudo vi /etc/nix/nix.conf       # ..or any other editor, if you prefer

    and then add the following lines:

    build-users-group = nixbld
    max-jobs = auto
    cores = 0
    sandbox = false
    require-sigs = true
    trusted-users = root
    allowed-users = *
    substituters =
    trusted-substituters =
    trusted-public-keys =
    extra-sandbox-paths = /System/Library/Frameworks /System/Library/PrivateFrameworks /usr/lib
    # If you are running on a Mac with M1 chip please uncomment 'system' setting to enforce running on Rosetta2
    # system = x86_64-darwin
  3. Run nix-shell with correct list of arguments or by using existing package.json scripts to load a shell with all the correct versions of all the required dependencies for development.


If you get SSL error when running nix-shell (SSL peer certificate or SSH remote key was not OK) try the next steps:

  1. Reinstall nix
    $ nix-env -e *
    $ curl -L | sh
  2. Download certificate from and import to your keychain.


Running Daedalus with Cardano Node


  1. Run yarn nix:selfnode from daedalus.

  2. Run yarn dev from the subsequent nix-shell (use KEEP_LOCAL_CLUSTER_RUNNING environment variable to keep the local cluster running after Daedalus exits: KEEP_LOCAL_CLUSTER_RUNNING=true yarn dev)

  3. Once Daedalus has started and has gotten past the loading screen run the following commands from a new terminal window if you wish to import funded wallets:

    • Byron wallets: yarn byron:wallet:importer
    • Shelley wallets: yarn shelley:wallet:importer
    • Mary wallets: yarn mary:wallet:importer (all of which contain native tokens which are visible once selfnode enters Mary era)
    • Yoroi Byron wallets: yarn yoroi:wallet:importer
    • ITN Byron wallets: yarn itn:byron:wallet:importer [Deprecated]
    • ITN Shelley wallets: yarn itn:shelley:wallet:importer [Deprecated]

    These scripts import 3 wallets by default. You can import up to 10 wallets by supplying WALLET_COUNT environment variable (e.g. WALLET_COUNT=10 yarn mary:wallet:importer).

    List of all funded wallet recovery phrases can be found here:


  • Cardano wallet process ID shown on the "Diagnostics" screen is faked and expected to match the Cardano node process ID.
  • Stake pool metadata is fetched directly by default (IOHK SMASH server option is not available).
  • Token metadata is fetched from a mock token metadata server which is automatically ran alongside the local cluster (there is no need to run it manually)
  • Daedalus will ask you if you wish to keep the local cluster running after it exits - this option is useful if you need to preserve local cluster state between Daedalus restarts.
Parameter Value
slotLength 0.2 sec
epochLength 50 slots
desiredPoolNumber 3
minimumUtxoValue 1 ADA


  1. Run yarn nix:mainnet from daedalus.
  2. Run yarn dev from the subsequent nix-shell


  1. Run yarn nix:flight from daedalus.
  2. Run yarn dev from the subsequent nix-shell


  1. Run yarn nix:testnet from daedalus.
  2. Run yarn dev from the subsequent nix-shell


  1. Run yarn nix:staging from daedalus.
  2. Run yarn dev from the subsequent nix-shell

Shelley QA

  1. Run yarn nix:shelley_qa from daedalus.
  2. Run yarn dev from the subsequent nix-shell

Alonzo Purple

  1. Run yarn nix:alonzo_purple from daedalus.
  2. Run yarn dev from the subsequent nix-shell

Native token metadata server

Daedalus, by default, uses the following metadata server for all networks except for the mainnet:

It's also possible to use a mock server locally by running the following command in nix-shell prior to starting Daedalus:

$ mock-token-metadata-server --port 65432 ./utils/cardano/native-tokens/registry.json
Mock metadata server running with url http://localhost:65432/

Then proceed to launch Daedalus and make sure to provide the mock token metadata server port:


This enables you to modify the metadata directly by modifying the registry file directly:

$ vi ./utils/cardano/native-tokens/registry.json        # ..or any other editor, if you prefer

Use the following command to check if the mock server is working correctly:

$ curl -i -H "Content-type: application/json" --data '{"subjects":["789ef8ae89617f34c07f7f6a12e4d65146f958c0bc15a97b4ff169f1"],"properties":["name","description","ticker","unit","logo"]}'

... and expect a "200 OK" response.

Updating upstream dependencies (cardano-wallet, cardano-node, and iohk-nix)

Niv is used to manage the version of upstream dependencies. The versions of these dependencies can be seen in nix/sources.json.

Dependencies are updated with the follow nix commands:

  • Update cardano-wallet to the latest master: nix-shell -A devops --arg nivOnly true --run "niv update cardano-wallet"
  • Update cardano-wallet to a specific revision: nix-shell -A devops --arg nivOnly true --run "niv update cardano-wallet -a rev=91db88f9195de49d4fb4299c68fc3f6de09856ab"
  • Update cardano-node to a specific tag: nix-shell -A devops --arg nivOnly true --run "niv update cardano-node -b tags/1.20.0"
  • Update iohk-nix to the latest master: nix-shell -A devops --arg nivOnly true --run "niv update iohk-nix -b master"


nix-shell also provides a script for updating yarn.lock file:

nix-shell -A fixYarnLock

Cardano Wallet Api documentation

Api documentation for edge cardano-wallet version:


If you use any 3rd party libraries which can't or won't be built with webpack, you must list them in your source/main/webpack.config.js and/or source/renderer/webpack.config.js

externals: [
  // put your node 3rd party libraries which can't be built with webpack here (mysql, mongodb, and so on..)

For a common example, to install Bootstrap, yarn install --save bootstrap and link them in the head of app.html

<link rel="stylesheet" href="../node_modules/bootstrap/dist/css/bootstrap.css" />
<link rel="image/svg+xml" href="../node_modules/bootstrap/dist/fonts/glyphicons-halflings-regular.eot" />

Make sure to list bootstrap in externals in webpack.config.base.js or the app won't include them in the package:

externals: ['bootstrap']


You can find more details regarding tests setup within Running Daedalus acceptance tests README file.

Notes: Be aware that only a single Daedalus instance can run per state directory. So you have to exit any development instances before running tests!


$ yarn run package

To package apps for all platforms:

$ yarn run package:all

To package apps with options:

$ yarn run package -- --[option]


  • --name, -n: Application name (default: Electron)
  • --version, -v: Electron version (default: latest version)
  • --asar, -a: asar support (default: false)
  • --icon, -i: Application icon
  • --all: pack for all platforms

Use electron-packager to pack your app with --all options for macOS, Linux and Windows platform. After build, you will find them in release folder. Otherwise, you will only find one for your OS.

Automated builds

CI/dev build scripts

Platform-specific build scripts facilitate building Daedalus the way it is built by the IOHK CI:


This script requires Nix, (optionally) configured with the IOHK binary cache.

scripts/ [OPTIONS..]

The result can be found at installers/csl-daedalus/daedalus-*.pkg.


This batch file requires Node.js and 7zip.


The result will can be found at .\daedalus-*.exe.

Pure Nix installer build

This will use nix to build a Linux installer. Using the IOHK binary cache will speed things up.

nix build -f ./release.nix mainnet.installer

The result can be found at ./result/daedalus-*.bin.