Binaries Install Guide

We have released Factom binaries to be run via command line and the Factoid Wallet GUI to make it easier for the community to run our software. Here is a step by step guide on how to install the binaries on Mac, Windows, and Linux.

Step #1 - Download the binaries for Mac, Windows, Linux on GitHub.

Step #2 - Save it to your desktop or downloads folder on your local hard drive.

Step #3 - Pick the instructions for your OS.

Mac

This installer is for factomd, fctwallet, factom-cli, and walletapp the 4 binaries will be installed in /Applications/FactomApps/ as well as a .factom folder in the root of the local user Home Folder. These are all required to run Factom via command line or the Factoid Wallet GUI.

Before you start go to System Preferences/Security & Privacy, click on the lock at the bottom left of the window, type your username and password, then select "Allow apps downloaded from: Anywhere". At the prompt click on “Allow From Anywhere”.

binaries1

Note, after running the Factom installer it is recommended you revert back your Security & Privacy settings to their original state.

Next, locate the factom.mpkg.zip file you just downloaded with the Finder and your mouse. Double click it to unzip it, then double click the factom.mpkg file to run the installer.

binaries2

The installer will come up, click continue.

binaries3

Then click install.

binaries4

The installer will prompt for your username and password, you need to have Admin privileges on the Mac (means you need to be able to install applications on your Mac). Enter your username and password then click Install Software.

binaries5

The installer will proceed with the installation and once finished it will prompt with "The installation was successful." Then click close.

binaries6

###p

First double click factomd to run it, this is what the Terminal output will look like:

binaries7

Then double click fctwallet, this is what the Terminal output will look like:

binaries8

Finally double click factom-cli to run it. This app in particular needs to run with some arguments and for the scope of this guide we will simply run it to show all the available commands which can be used to perform various functions. So in the Terminal window type:

./factom-cli help

This will show all the available commands and their usage.

Windows

This installer is for factomd, fctwallet, factom-cli, and walletapp these are all required to run Factom via command line or via the ###a href="Factoid" class="redactor-linkify-object">https://www.factom.com/factoid... Wallet GUI.

Download factom.msi and save it to a folder on the c: drive.

Double click factom.msi to run it. If you get the below message:

binaries10

Click on "more info" to expand it then select "Run Anyway":

binaries10a

The Installer will then run, click "Next":

binaries10b

Select "I accept the terms in the Licence Agreement and click "Next" to continue:

binaries10c

Make sure Factom is installed into c:\Program Files (x86)\Factom\ folder and click "Next" to continue:

binaries11

The click "Install":

binaries11a

Select "Yes" to continue if you get a message as below:

binaries11b

When the installation is over select "Finish" to exit:

binaries11c

###p

binaries11d

First double click the “Factomd” icon on your desktop to run it, this is what the CMD window output will look like:

binaries12

Then, browse to c:\Program Files (x86)\Factom\ and double click on fctwallet this is what the CMD output will look like:

binaries13

Start a CMD window and cd to c:\Program Files (x86)\Factom\. This app in particular needs to run with some arguments and for the scope of this guide we will simply run it to show all the available commands which can be used to perform various functions. So in the CMD window type:

factom-cli.exe help

this is what the CMD window output will look like:

binaries14

Linux

This installer is for factomd, fctwallet, factom-cli, and walletapp these are all required to run Factom via command line or the ###a href="Factoid" class="redactor-linkify-object">https://www.factom.com/factoid... Wallet GUI. The Linux installer will work for Debian and Ubuntu but not for RedHat Linux.

Download the factom.deb installer then run this command to install:

sudo dpkg --force-architecture -i ./factom.deb

After the installer has finished you will be able to run each binary by using the commands below.

First run factomd:

factomd

Then run fctwallet:

fctwallet

factom-cli in particular needs to run with some arguments and for the scope of this guide we will simply run it to show all the available commands which can be used to perform various functions. So run this command:

factom-cli help