Native Installation

This page contains instructions for installing xud natively, without treating setup of dependencies like bitcoind or lnd. It is mainly geared towards developers. For all other users, we recommend our streamlined setup via xud-docker.


Make sure to have the folloiwng installed:

Cloning from GitHub

Testers and developers should clone the repository from GitHub and install dependencies.

git clone
cd xud
npm install
npm run compile
npm run compile:seedutil

Installing from npm

sudo npm install xud -g --unsafe-perm

Daemonize xud

If you want to daemonize xud so it starts on boot without needing its own terminal, you can do this using systemd. The following sample systemd configuration was tested on Ubuntu 20.04:

Description= XUD - ExchangeUnion Daemon
ExecStart=/usr/bin/node /opt/xud/dist/Xud.js

Tips 'n Tricks

  • When installing natively on a Raspberry Pi you might see Unexpected error during initialization. Here the solution. If you see an install error when installing via npm i, try npm install --production.