Installation

Guides on how to install the Enterprise wallet and Factom Federation are shown here.

Install Enterprise Wallet

Enterprise wallet has been updated to be installed as a Desktop Application for Windows, Mac, or Linux. The process of backing up your wallets remains the same, and the desktop app uses the same file locations as the binary version (factom-walletd). This guide will go over the installation of the new Enterprise Wallet.

For people who have run Factom Genesis (FG), our previous software release, you may need to import an old wallet file in the new wallet. We strongly recommend to only install the wallet desktop app at this stage without running it until you get familiar with the next guide: Run Enterprise Wallet.

Here is a step by step guide on how to install Enterprise Wallet on Mac, Windows, and Linux:

  1. Download the installer for Mac, Windows, or Linux on GitHub.

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

  3. Follow the instructions for your OS below.

Mac

Double click on the “enterprise-wallet-setup.dmg” file downloaded at Step 1, when prompted drag EnterpriseWallet.app into the Applications folder.

Install Mac Wallet

The wallet will be installed at the following location:

/Applications/EnterpriseWallet.app

Double click the app to launch it or drag to your dock to create a shortcut.

You are ready to Run Enterprise Wallet. However, read the guide carefully before you run the app, especially if you have an old wallet file to import.

Windows

Double click on the “enterprise-wallet-setup-amd64.ex file downloaded in Step 1 to run the wallet installer.

Wait until it loads up.

Install Windows Wallet

Then follow the prompts and click install. Let the installer finish.

Install Windows Wallet 2

The wallet will be installed at the following location:

C:\Users\YOUR_USERNAME\AppData\Local\Programs\enterprisewallet\EnterpriseWallet.exe

A shortcut will also be added to your desktop for easy launch.

You are ready to Run Enterprise Wallet. However, read the guide carefully before you run the app, especially if you have an old wallet file to import.

Linux

For Ubuntu/Debian

Locate the enterprise-wallet-setup-amd64.deb file downloaded at Step 1 to run the wallet installer.

Open a terminal window and go to where the .deb is located, for example:

cd ~/Downloads

Install the .deb package with this command:

sudo dpkg -i enterprise-wallet-setup-amd64.deb
Install Linux Wallet

You will be able to run the wallet by simply searching for it in the search bar.

Install Linux Wallet 2

For Redhat/Centos

Locate the enterprise-wallet-linux.zip and unzip it into a folder of your choice. Then open a Terminal window and cd to the “linux-unpacked” folder, for example:

cd ~/Desktop/linux-unpacked

You location may be different and you can also change the folder name from “linux-unpacked” to “EnterpriseWallet” or something more meaningful to you.

Then run the wallet by executing the “enterprisewallet” binary with the following command:

enterprisewallet

You are ready to Run Enterprise Wallet. However, read the guide carefully before you run the app, especially if you have an old wallet file to import.

Install Factom Federation (FF)

If you got this far, you are doing well Grasshopper. Ready to get your hands on FF? You will be up and running in a few minutes. Promise.

Here is a step by step guide on how to install FF binaries on Mac, Windows, and Linux.

  1. Download the installer for Mac, Windows, or Linux on GitHub. There are various versions, make sure to select the one best suited for your system.

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

  3. Follow the instructions for your OS.

    1. Mac

Mac

This installer is for factomd, factom-walletd, factom-cli, the three binaries will be installed in /Applications/Factom/ together with a .factom folder in the root of the local user Home Folder. These are all required to run Factom via command line.

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.”

Security & Privacy

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

Next, locate the “factom.mpkg.zip” file you just downloaded, double-click to unzip it, then double-click the “factom.mpkg” file to run the installer.

The installer will open, click continue.

Installer Step 1

Then click install.

Installer Step 2

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.

Installer Step 3

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

Installer Step 4

You made it so far! Wasn’t that hard, was it?

You are now ready to install Enterprise Wallet.

Windows

This installer is for factomd, factom-walletd, factom-cli, the three binaries will be installed in c:\Program Files (x86)\Factom\ or c:\Program Files\Factom\ (depending on your system) together with a .factom folder in the root of the local user Home Folder. These are all required to run Factom via command line.

Next, locate the “FactomInstall-amd64.msi” or “FactomInstall-i386.msi” file you just downloaded in Step 1.

Double click the .msi installer to run it, but you may be prompted with the following message.

Windows Prompt 1

Click on “more info” to expand it then select “Run anyway.”

Windows Prompt 2

The Installer will open, click “Next.”

Installer Step 1

Select “I accept the terms in the License Agreement” and click “Next” to continue.

Installer Step 2

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

Installer Step 3

Then click “Install.”

Installer Step 4

Select “Yes” to continue if you get the following message.

Windows Prompt 3

When the installation is over select “Finish” to exit the installer.

Installer Step 5

You made it so far, and ready to install Enterprise Wallet.

Linux

This installer is for factomd, factom-walletd, factom-cli, the three binaries will be installed on your local drive together with a .factom folder in the root of the local user Home Folder ~/.factom. These are all required to run Factom via command line or the Factom Foundation Wallet.

Download the “factom-amd64.deb” or “factom-i386.deb” installer that suits your system as per Step 1 then run the following command to install.

sudo dpkg -i ./factom-amd64.deb

or

sudo dpkg -i ./factom-i386.deb

We are aware Linux users are hardcore, so we made sure one command is all they need to be ready to install Enterprise Wallet!

Docker

If you’ve made it this far, you may not have an operating system. This will make it very difficult to run Factom Federation since, at this point, we do still require you to use a computing device. However, if you’re simply looking for a way to get started in ANY environment, you’ve come to the right place.

Because we are a very modern organization, we’ve made arrangements for you to get started in a containerized environment. All you need is Docker at minimum v17 and a clone of the factomd repo.

Build

From wherever you have cloned the factomd repo, run:

docker build -t factomd_container .

You can replace factomd_container with whatever you want to call the container. e.g. factomd, foo, etc.

Cross-Compile

To cross-compile for a different target, you can pass in a build-arg :

docker build -t factomd_container --build-arg GOOS=darwin .

Run

No Persistence

docker run --rm -p 8090:8090 factomd_container
  • This will start up factomd with no flags.

  • The Control Panel is accessible at port 8090..

  • When the container terminates, all data will be lost

In the above, replace factomd_container with whatever you called it when you built it - e.g. factomd, foo, etc.

With Persistence

docker volume create factomd_volume
docker run --rm -v $(PWD)/factomd.conf:/source -v factomd_volume:/destination busybox /bin/cp /source /destination/factomd.conf
docker run --rm -p 8090:8090 -v factomd_volume:/root/.factom/m2 factomd_container
  • This will start up factomd with no flags.

  • The Control Panel is accessible at port 8090

  • When the container terminates, the data will remain persisted in the volume factomd_volume

  • The above copies factomd.conf from the local directory into the container. Put your version in there, or change the path appropriately.

In the above:

  • replace factomd_container with whatever you called it when you built it - e.g. factomd, foo, etc.

  • replace factomd_volume with whatever you might want to call it - e.g. myvolume, barbaz, etc.

Additional Flags

In all cases, you can startup with additional flags by passing them at the end of the docker command, e.g.

docker run --rm -p 8090:8090 factomd_container -port 9999

Copy

docker run --rm --entrypoint='' \
-v <FULLY_QUALIFIED_PATH_TO_TARGET_DIRECTORY>:/destination factomd_container \
/bin/cp /go/bin/factomd /destination

The following will copy the binary to /tmp/factomd

docker run --rm --entrypoint='' \
-v /tmp:/destination factomd_container \
/bin/cp /go/bin/factomd /destination

So yeah, you want to get your binary out of the container. To do so, you basically mount your target into the container and copy the binary over as shown. You should replace factomd_container with whatever you called it in the build section above e.g. factomd, foo, etc.

Cross-Compile Copy

Cross-Compile copy

docker run --rm --entrypoint='' \
-v <FULLY_QUALIFIED_PATH_TO_TARGET_DIRECTORY>:/destination \
factomd_container \
/bin/cp /go/bin/darwin_amd64/factomd /destination

To copy the darwin_amd64 version of the binary to /tmp/factomd

docker run --rm --entrypoint=''
-v /tmp:/destination factomd_container \
/bin/cp /go/bin/darwin_amd64/factomd /destination

If you cross-compiled to a different target, your binary will be in /go/bin/<target>/factomd. e.g. If you built with --build-arg GOOS=darwin, then you can copy out the binary using the commands shown on the right.You should replace factomd_container with whatever you called it in the build section above e.g. factomd, foo, etc.