How to build NBFC

If you want to build NBFC from source, the first thing you have to do is to download the source code. You can easily clone the NBFC repository via git.

If you want to build the latest version of NBFC, you don't have to clone the whole repository, but only the latest revision:
git clone --depth 1 https://github.com/hirschmann/nbfc.git

If you want to build a specific version of NBFC, first clone the whole repository:
git clone https://github.com/hirschmann/nbfc.git
Then check out the version you want to build:
git checkout 1.4.2

If you aren't familiar with git you can download the latest revision of the source code as .zip file on github.

Build on Windows

Make sure these packages are installed on your machine:

• Visual Studio 2017 (Community)
• WiX Toolset v3.11

To build the solution, run the build.ps1 script (which is included in the cloned repo) via Windows Powershell.
If the build was successful there should be a setup file (NbfcBootstrapper.exe) at nbfc\Windows\Setup\NbfcBootstrapper\bin\Release\.

Build on Linux

Make sure the Mono runtime + development tools are installed on your machine (Debian based distros: mono-complete, Arch based distros: mono).

To build the solution, run the build.sh script (which is included in the cloned repo).
The result can be found at nbfc/Linux/bin/Release.

In case you encounter build errors, try to update the Mono runtime, either via your distro's package manager, or following these instructions: http://www.mono-project.com/download/

Build on Linux via Docker

If you cannot build nbfc with your local mono installation for some reason or you don't want to install mono locally, it might be a good option to build it via docker:

1. First, you need to install docker on your computer (see the official documentation).

2. Clone the nbfc repository (as described here).

    $ git clone --depth 1 https://github.com/hirschmann/nbfc.git nbfc

3. Start mono docker image.

    $ docker run -it -v $(pwd)/nbfc:/nbfc mono:latest bash

This pulls and runs the latest mono docker image with the current nbfc directory mounted into the container. Then, once the shell of the docker container opens, change to the mounted nbfc directory using cd /nbfc/ and build by executing ./build.sh. After building nbfc finished, exit the shell via exit and check your local directory for content in nbfc/Linux/bin/Release/