Skip to main content

Hive Testnet Setup

Setup a private HAF-enabled Hive development testnet to test Alive Protocol without creating additional blockchain bloat on the mainnet. Most of this guide should be very similar to the mainnet HAF node setup guide but with testnet-related build flags.

Node Requirements


The system requirements of running a HAF-enabled Hive testnet is very minimal as there is no data to begin with. Significantly more resources are required to compile the binaries for use in the testnet.

  • Dual-core CPU
  • 1GB RAM
  • 15GB SSD
  • 100Mbps bandwidth for Alive Protocol video streams

For compilation


These are the minimum recommended specs to compile hived. You may be able to compile with lower specifications but it may take significantly longer time to complete.

  • 8-core CPU (AMD Zen 1 or 9th gen Intel Core or better)
  • 32GB RAM
  • 20GB SSD free space

Setup Dependencies

sudo apt-get update && sudo apt-get upgrade
sudo apt-get install -y \
autoconf \
automake \
cmake \
g++ \
git \
zlib1g-dev \
libbz2-dev \
libsnappy-dev \
libssl-dev \
libtool \
ninja-build \
pkg-config \
doxygen \
libncurses5-dev \
libreadline-dev \
perl \
python3 \
python3-jinja2 \
libboost-all-dev \
libpqxx-dev \
postgresql \

Compile hived

git clone
cd haf
git submodule update --init --recursive
mkdir build
cd build

Install HAF extensions

With Ninja

sudo ninja install



Useful when build server is not the node running the testnet.

# In `build` folder
sudo cp lib/libhfm-* /usr/lib/postgresql/14/lib
sudo cp extensions/hive_fork_manager/* /usr/share/postgresql/14/extension

# Fix permissions
sudo chmod 644 /usr/lib/postgresql/14/lib/libhfm-*
sudo chmod 644 /usr/share/postgresql/14/extension/hive_fork_manager*

Setup HAF db

Enter the psql shell as postgres user:

sudo -i -u postgres psql

Create the db with permissions and extensions:

# Roles
CREATE ROLE hive_applications_group WITH NOLOGIN;
CREATE ROLE hived LOGIN PASSWORD 'hivedpass' INHERIT IN ROLE hived_group;

# Set password if needed
ALTER ROLE role_name WITH PASSWORD 'rolepass';

# Database used by hived
CREATE DATABASE block_log_testnet;

# Use database
\c block_log_testnet

# sql_serializer plugin on db


By default, Postgresql allows only for peer authentication. You may enable password authentication by appending the following line in /etc/postgresql/14/main/pg_hba.conf:

local all all peer # after this line
local all all md5 # add this

For more details, refer to the documentation here.

Configure hived

Generate a hived config file if not already:

hived --dump-config

Then edit the config.ini file in the data directory as follows (find the key and modify its value, add them if it is not there):


# Basic
plugin = witness webserver p2p json_rpc database_api network_broadcast_api condenser_api block_api rc_api

# Get accounts/witness
plugin = account_by_key account_by_key_api

# Transaction status
plugin = transaction_status transaction_status_api

# SQL serializer
plugin = sql_serializer

SQL serializer

psql-url = dbname=block_log_testnet user=hived password=hivedpass hostaddr= port=5432
psql-index-threshold = 1000000
psql-operations-threads-number = 5
psql-transactions-threads-number = 2
psql-account-operations-threads-number = 2
psql-enable-account-operations-dump = true
psql-force-open-inconsistent = false
psql-livesync-threshold = 10000

hived API Endpoint

Configure the IP and port of the endpoints to be made available for API calls.

webserver-http-endpoint =

Enable stale production

enable-stale-production = 1
required-participation = 0

Start Testnet

Retrieve initminer keys:


Upon starting hived, the initminer keypair will be logged as follows:



initminer private key: 5JNHfZYKGaomSFvd4NUdQ9qMcEAC43kujbfjueTHpVapX1Kzq2n
initminer public key: TST6LLegbAgLAy28EHrffBVuANFWcFgmqRMW13wBmTExqFE9SCkg4
chain id: 18dcf0a285365fc58b71f18b3d3fec954aa0c141c44e4e5cb4cf777b9eab274e
blockchain version: 1.27.0

hived git_revision: "7aabdfa48b1a5af44abf7e33d069567fef190460"

Insert the provided private key into config.ini:

witness = "initminer"
private-key = 5JNHfZYKGaomSFvd4NUdQ9qMcEAC43kujbfjueTHpVapX1Kzq2n

Then start hived again.