Skip to content

Latest commit

 

History

History
109 lines (75 loc) · 2.1 KB

build-freebsd.md

File metadata and controls

109 lines (75 loc) · 2.1 KB

Building on FreeBSD

Updated for FreeBSD 12.2

This guide describes how to build gridcoinresearchd, command-line utilities, and GUI on FreeBSD.

Preparing the Build

Install the required dependencies the usual way you install software on FreeBSD - either with pkg or via the Ports collection. The example commands below use pkg which is usually run as root or via sudo. If you want to use sudo, and you haven't set it up: use this guide to setup sudo access on FreeBSD.

General Dependencies

pkg install cmake
# or
pkg install autoconf automake gmake libtool

pkg install boost-libs curl db5 leveldb libzip openssl pkgconf secp256k1

GUI Dependencies

pkg install qt5 libqrencode

Test Suite Dependencies

There is an included test suite that is useful for testing code changes when developing. To run the test suite (recommended), you will need to have the following packages installed:

  • With CMake:

    pkg install vim
  • With Autotools:

    pkg install python3

Clone the repository and cd into it:

git clone https://github.com/gridcoin-community/Gridcoin-Research
cd Gridcoin-Research
git checkout master

To Build

1. Configuration

There are many ways to configure Gridcoin, here are a few common examples:

Wallet Support, No GUI:

This configuration does not enable the GUI.

  • With CMake:

    mkdir build && cd build
    cmake ..
  • With Autotools:

    ./autogen.sh
    ./configure --with-gui=no \
    	MAKE=gmake

2. Compile

  • With CMake:

    cmake --build . # use "-j N" for N parallel jobs
    ctest . # Run tests
  • With Autotools:

    gmake # use "-j N" for N parallel jobs

3. Test

  • With CMake:

    cmake .. -DENABLE_TESTS=ON
    cmake --build .
    ctest .
  • With Autotools:

    gmake check