Skip to content
master
Switch branches/tags
Code

Coverity Scan Discord

Building

Cloning

Be sure to properly clone the repository:

$ git clone --recursive https://github.com/hyle-team/zano.git

Dependencies

component / version minimum
(not recommended but may work)
recommended most recent of what we have ever tested
gcc (Linux) 5.4.0 7.2.0 8.3.0
llvm/clang (Linux) UNKNOWN 7.0.1 8.0.0
MSVC (Windows) 2015 (14.0 update 1) 2017 (15.5.7) 2019
XCode (macOS) 7.3.1 9.2 9.2
CMake 2.8.6 3.15.5 3.15.5
Boost 1.56 1.68 1.68
Qt (only for GUI) 5.8.0 5.11.2 5.13.2

Linux

Recommended OS version: Ubuntu 18.04 LTS.

  1. Prerequisites

    1. Prerequisites for server version:

      sudo apt-get install -y build-essential g++ python-dev autotools-dev libicu-dev libbz2-dev cmake git screen
      
    2. Prerequisites for GUI version:

      sudo apt-get install -y build-essential g++ python-dev autotools-dev libicu-dev libbz2-dev cmake git screen mesa-common-dev libglu1-mesa-dev`
      
  2. Download and build Boost

    wget https://dl.bintray.com/boostorg/release/1.68.0/source/boost_1_68_0.tar.bz2
    tar -xjf boost_1_68_0.tar.bz2
    cd boost_1_68_0
    ./bootstrap.sh --with-libraries=system,filesystem,thread,date_time,chrono,regex,serialization,atomic,program_options,locale,timer
    ./b2
    
  3. Install Qt

    wget https://download.qt.io/new_archive/qt/5.11/5.11.2/qt-opensource-linux-x64-5.11.2.run
    chmod +x qt-opensource-linux-x64-5.11.2.run
    ./qt-opensource-linux-x64-5.11.2.run
    

    Then follow the instructions in Wizard. Don't forget to tick WebEngine module!

  4. Set BOOST_ROOT and QT_PREFIX_PATH envinorment variables
    For instance, by adding these lines to ~/.bashrc:

    export BOOST_ROOT=/home/user/boost_1_68_0  
    export QT_PREFIX_PATH=/home/user/Qt5.11.2/5.11.2/gcc_64
    
  5. Building binaries

    1. Building daemon and simplewallet:

      cd zano/ && make -j1
      

      or

      cd zano && mkdir build && cd build
      cmake ..
      make -j1 daemon simplewallet
      

      NOTICE: If you are building on machine with relatively high anount of RAM or with proper setting of virtual memory, then you can use -j2 or -j option to speed up the building process. Use with caution.

    2. Building GUI:

      cd zano
      utils/build_sript_linux.sh
      
  6. Look for the binaries in build folder

Windows

Recommended OS version: Windows 7 x64.

  1. Install required prerequisites (Boost, Qt, CMake).
  2. Edit paths in utils/configure_local_paths.cmd.
  3. Run utils/configure_win64_msvs2015_gui.cmd or utils/configure_win64_msvs2017_gui.cmd according to your MSVC version.
  4. Go to the build folder and open generated Zano.sln in MSVC.
  5. Build.

In order to correctly deploy Qt GUI application you also need to do the following: 6. Copy Zano.exe to a folder (e.g. depoy). 7. Run PATH_TO_QT\bin\windeployqt.exe deploy/Zano.exe. 8. Copy folder \src\gui\qt-daemon\html to deploy\html.

macOS

Recommended OS version: macOS Sierra 10.12.6 x64.

  1. Install required prerequisites.
  2. Set environment variables as stated in utils/macosx_build_config.command.
  3. mkdir build
    cd build
    cmake ..
    make

To build GUI application:

  1. Create self-signing certificate via Keychain Access:
    a. Run Keychain Access.
    b. Choose Keychain Access > Certificate Assistant > Create a Certificate.
    c. Use “Zano” (without quotes) as certificate name.
    d. Choose “Code Signing” in “Certificate Type” field.
    e. Press “Create”, then “Done”.
    f. Make sure the certificate was added to keychain "System". If not—move it to "System".
    g. Double click the certificate you've just added, enter the trust section and under "When using this certificate" select "Always trust".
    h. Unfold the certificate in Keychain Access window and double click underlying private key "Zano". Select "Access Control" tab, then select "Allow all applications to access this item". Click "Save Changes".
  2. Revise building script, comment out unwanted steps and run it: utils/build_script_mac_osx.sh
  3. The application should be here: /buid_mac_osx_64/release/src