1. Home
  2. Knowledge Base
  3. Wallet Build Guide
  4. macOS Build Guide

BEFORE YOU START: Please back up your wallet.dat file. While we’re pretty sure that this will in no way affect your wallet, it’s always better to have a backup, and we’re not responsible for any loss of Vulcano or sanity on your part.

How to compile Vulcano

First off, it is required to install Homebrew – we’re also going to use a shell, by default this is in /Applications/Utilities/Terminal.app – everything you do here will run and then return you back to your input prompt – do not start a new command before the previous one has finished!

Note: If you already have Homebrew installed, make sure you uninstall boost first! We need version 1.57 to compile the wallet. If you don’t know what that means, just ignore this sentence and continue on.

After installing XCode, start a shell and install Homebrew:

/usr/bin/ruby -e “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)”

Homebrew is like an App Store for your command line, which allows us to install various Unix tools that will be needed for the build. Follow the instructions on screen and there will be no problems. Once done, we need to install some other required items:

brew install autoconf automake [email protected] [email protected] git libevent libtool miniupnpc openssl pkg-config protobuf qt zeromq librsvg

We need a specific version of boost to build the current Vulcano wallet, and now that it’s installed, it will need to be linked. Use the following command:

brew link [email protected] –force

Now we’re going to switch into your Downloads folder:

cd ~/Downloads

The next step is to download the current version of the wallet from Github and go into that directory:

git clone https://github.com/vulcano-crypto/Vulcano.git && cd Vulcano

We’re in the Vulcano directory. The next step is to set some configuration flags:

export LDFLAGS=-L/usr/local/opt/openssl/lib;export CPPFLAGS=-I/usr/local/opt/openssl/include

Next, autogen additional files:


Configure everything (note the dot and slash at the beginning of the line!):


Next is to build the wallet (this is gonna take a while):


If you want to use Vulcano as a regular macOS app, continue with “How to get a Vulcano-QT App”. If, for whatever reason, you prefer to use the command line tools, continue with “How to use the command line tools”.

How to get a Vulcano-QT App

After make is finished, you can create an App bundle inside a disk image with:

make deploy

Once this is done, you’ll find Vulcano-Qt.dmg inside your Vulcano folder. Open and install as usual.

How to use the command line tools

Once the build is complete, switch into the src/qt subdirectory:

cd src/qt

And the  wallet installed – you can start it by running:


If you want to start your wallet in the future, open Terminal.app and run this command:




A: You need to start your wallet with -forcestart: ./vulcano-qt -forcestart


Related Articles