1. Home
  2. Linux

How To Install mSigna On Linux

Installing the mSigna wallet on Linux requires building. Compiling this software works on nearly any Linux distribution. To get started with this process, you’ll first need to satisfy the dependencies it has. Unfortunately, the mSigna website is very vague and doesn’t offer up any distro-specific packages that users must install.

To get this program to build, you’ll need the Qt5 libraries, ODB, OpenSSL, the Boost C++ libraries, SQLite, git, and qrencode. For more information about how to find the dependencies for your Linux distribution, head over to the official documentation page here.

Install mSigna

After all of the dependencies are installed on your Linux operating system, open up a terminal window and use the git tool to download the latest source code.

Note: mSigna may still build even if you don’t install the dependencies on your Linux PC. Check ~/mSigna/deps for the included dependency files. The builder may use those instead.

git clone https://github.com/ciphrex/mSIGNA

Building mSigna dependencies

Earlier we used Git to download all of the mSigna source code files quickly. Going this route is useful, as it removes annoying steps like extracting archive files, etc. At this point, you’ll need to move the terminal from the home folder it opens at to the newly cloned mSigna source files. To do that, use the CD command.


Inside the mSigna folder, there is a “docs” sub-folder. In this folder, a detailed description for setting up a Linux build environment is outlined. It involves downloading, building and installing important files. Keep in mind that these files don’t take away from the “deps” folder. If you’ve installed these libraries via your Linux distribution’s package manager, feel free to skip this process.

In a terminal, run these commands one after the other. Soon after mSigna should have all the dependency files it needs to build correctly.

cd ~/
mkdir odb

cd odb

First, install Libcutl:

wget http://www.codesynthesis.com/download/libcutl/1.8/libcutl-1.8.0.tar.bz2
tar -xjvf libcutl-1.8.0.tar.bz2
cd libcutl-1.8.0
sudo make install
sudo ldconfig
cd ..

Next, the ODB compiler.

sudo apt-get install gcc-4.8-plugin-dev
wget http://www.codesynthesis.com/download/odb/2.3/odb-2.3.0.tar.bz2
tar -xjvf odb-2.3.0.tar.bz2
cd odb-2.3.0
sudo make install
cd ..

After the ODB Compiler, build and install the ODB Common Runtime:

wget http://www.codesynthesis.com/download/odb/2.3/libodb-2.3.0.tar.bz2
tar -xjvf libodb-2.3.0.tar.bz2
mkdir libodb-linux-build
cd libodb-linux-build 
sudo make install
cd ..

Finish up the ODB dependencies by installing the ODB Database Runtime Library.

wget http://www.codesynthesis.com/download/odb/2.3/libodb-sqlite-2.3.0.tar.bz2
tar -xjvf libodb-sqlite-2.3.0.tar.bz2
mkdir libodb-sqlite-linux-build
cd libodb-sqlite-linux-build
sudo make install

Build the Qrencode library. Unlike the other dependencies, Qrencode is included with the source code, in “deps.”

cd mSIGNA/deps/qrencode-3.4.3
./configure --without-tools
sudo make install
cd ..

Lastly, install the Coin-related files mSigna needs:

sh ~/mSIGNA/deps/CoinDB/install-all.sh
sh ~/mSIGNA/deps/CoinCore/install-all.sh
sh ~/mSIGNA/deps/CoinQ/install-all.sh

After all of the dependencies are built, compile the mSigna wallet.

./build-all.sh linux

Using mSigna

Setting up your mSigna wallet starts out by creating a new vault. Click on “File,” and select the option that says “New Vault.” Give your new vault a nickname, and save it.

Note: if you’re not running Bitcoin-qt in the background alongside mSigna, you’ll need to connect to a node manually. Look at the mSigna documentation to learn more.

Next, find the accounts menu and click the option that says “Account Wizard.” Start up the wizard and give your account a name.

After naming the account, set the account policy. For most users, 1 of 1 should suffice. Only change policy options if you know what you’re doing.

When the setup finishes, click “Export Account” to create a new backup. This backup will save everything related to your wallet, so be sure to save it in a safe place.

Sending Payments

mSigna will take some time to sync with the latest version of the Bitcoin blockchain. When this process completes, it’ll be safe to use. Click “Accounts” and select the “Send” button.

Note: look for the “Keychains” menu and select “Unlock keychain.” Unlocking your keychain is critical to sending BTC transactions.

In the pop-up menu for mSigna, write in the exact amount (in BTC) you’d like to send. If everything looks good and you’re ready to send the payment, click the “Save Unsigned” button.

The payment isn’t ready to send yet. You’ll first need to sign it. Look at the transaction (under Transactions) and select it. Click on the transaction, and select the “Add signature” to sign the transaction.

When you’ve met the requirement for your wallet’s security policy, the “Send” button will appear, and you’ll be able to send the payment.

Receiving Payments

To receive a payment to your mSigna BTC wallet, select your account and click the “Recieve” button in the toolbar. Label the new payment, and write in the required amount.

Wait a little bit, and mSigna will generate a new QR code address for payment. Give the address to the person paying to get the payment.

When a payment is successful, mSigna will instantly credit BTC to your account.

Leave a comment