Building INTcoin from source — complete guide

Development
1

INTcoin must be compiled from source on the machine that will run it. RandomX optimises for the specific CPU instruction set available at compile time, so a binary built on one machine may not work correctly on another.

Prerequisites

Linux (Ubuntu/Debian):

sudo apt update
sudo apt install -y build-essential cmake git python3 pkg-config \
    autoconf automake libtool bison

Linux (Fedora):

sudo dnf install -y gcc gcc-c++ cmake git python3 pkg-config \
    autoconf automake libtool bison

Linux (Arch):

sudo pacman -S base-devel cmake git python pkg-config autoconf automake libtool bison

macOS:

xcode-select --install
brew install cmake autoconf automake libtool pkg-config bison

You need CMake 3.30+ and a C++23 compiler (GCC 13+ or Clang 17+).

Build Steps

1. Clone the repository

git clone https://gitlab.com/INT-devs/intcoin.git
cd intcoin

2. Build dependencies

The depends system downloads and compiles all libraries (liboqs, RandomX, Boost, LevelDB, OpenSSL, Snappy) from source. This ensures reproducible builds and avoids system library conflicts.

Daemon, CLI, miner, and wallet tool:

cd depends
make -j$(nproc)
cd ..

Include the Qt6 desktop wallet:

cd depends
make -j$(nproc) QT=1
cd ..

The depends build takes 15-30 minutes depending on your hardware. It only needs to be done once unless you update dependencies.

3. Configure

cmake -B build --toolchain depends/$(depends/config.guess)/toolchain.cmake

4. Compile

cmake --build build -j$(nproc)

Binaries are placed in build/bin/:

  • intcoind — full node daemon
  • intcoin-cli — RPC command-line client
  • intcoin-miner — standalone miner
  • intcoin-wallet — offline wallet tool
  • intcoin-qt — desktop wallet (if built with QT=1)

5. Run tests

./build/bin/test_intcoin

31 test suites covering consensus, wallet, networking, and cryptographic operations.

Quick Start After Building

# Start the daemon
./build/bin/intcoind

# In another terminal, check sync status
./build/bin/intcoin-cli getblockchaininfo

# Create a wallet
./build/bin/intcoin-cli createwallet "mywallet"

# Get a receiving address
./build/bin/intcoin-cli getnewaddress

Common Build Issues

CMake version too old: Ubuntu 22.04 ships CMake 3.22. Either upgrade via pip (pip install cmake) or use Ubuntu 24.04+.

GCC too old: You need GCC 13+ for C++23 support. On older distros, install from a PPA or use Clang 17+.

Out of memory during build: liboqs and Qt are the heaviest. If you have less than 4 GB RAM, reduce parallel jobs: make -j2 instead of make -j$(nproc).

macOS linker errors: Ensure you’re using the Homebrew-installed tools, not the Apple system versions. The depends system handles this automatically via the toolchain file.

Updating

cd /path/to/intcoin
git pull
cmake --build build -j$(nproc)

The depends only need rebuilding if dependency versions change (rare). A normal code update only requires the cmake --build step.

Full documentation: BUILDING.md