Skip to content


Repository files navigation

Sia Load Tester

Build Status Coverage Status License


A load tester for Sia.


You must have the following installed on your test machine:

  • Python 2.7
  • git
  • Sia 1.x
  • A Sia wallet funded with at least 400 SC

The load test is platform-agnostic and will work on any system that provides a Python 2.7 environment. The examples below use Windows PowerShell syntax because that is what I used for the actual test.


# Directory in which to install tools for Sia load test.

git clone

git clone
pushd sia_metrics_collector
pip install -r requirements.txt

git clone
pushd .\sia_load_tester\
pip install -r requirements.txt
mkdir $Env:SIA_TEST_ROOT



Performing a load test

Step 1: Generate dummy data (optional)

To perform the load test, you will need data to upload to Sia.

To generate simulated data, you can use the dummy_file_generator.

Optimal case

To test Sia's optimal case, generate files of 41942760 bytes each:

# Target directory and file prefix for output files.

$Env:SIZE_PER_FILE="41942760"         # ~40 MiB
$Env:TOTAL_DATA_SIZE="10995116277760" # 10 TiB

python "$Env:SIA_TOOLS_DIR\dummy_file_generator\dummy_file_generator\" `
  --size_per_file "$Env:SIZE_PER_FILE" `
  --total_size "$Env:TOTAL_DATA_SIZE" `
  --output_prefix "$Env:OUTPUT_PREFIX"

Worst case

To test Sia's worst case, generate files of 1 byte each:

# Target directory and file prefix for output files.

$Env:SIZE_PER_FILE="1"          # 1 byte
$Env:TOTAL_DATA_SIZE="250000"   # ~244 KiB

python "$Env:SIA_TOOLS_DIR\dummy_file_generator\dummy_file_generator\" `
  --size_per_file "$Env:SIZE_PER_FILE" `
  --total_size "$Env:TOTAL_DATA_SIZE" `
  --output_prefix "$Env:OUTPUT_PREFIX"

Step 2: Prepare Sia

In a separate terminal window, start the siad command-line daemon:

.\siad --modules cgtwr

Use siac to unlock your wallet.

.\siac wallet unlock

You don't need to create renter contracts, as the load tester will automatically allocate your full wallet balance to renter contracts when the test begins.

Step 3: Start Sia metrics collector (optional)

The Sia metrics collector regularly polls Sia to gather metrics about its performance. It's not strictly necessary to the load test, but it captures useful data about Sia's behavior.

python "$Env:SIA_TOOLS_DIR\sia_metrics_collector\sia_metrics_collector\"`
  --poll_frequency 60 `
  --output_file "$Env:SIA_TEST_OUTPUT\metrics.csv"

Start load tester

You can run the load test using an existing directory or by generating dummy data (see above).

Specify the data directory using the --dataset_root flag. The load tester will find all files in the directory recursively and upload all files in that directory that have not already been uploaded to Sia.

python "$Env:SIA_TOOLS_DIR\sia_load_tester\sia_load_tester\"`
  --dataset_root $Env:SIA_UPLOAD_DATA_DIR `
  --output_dir $Env:SIA_TEST_OUTPUT

The load tester will automatically exit when one of the following occurs:

  • All files in dataset root have been fully uploaded.
  • Upload bandwidth has dropped below 3 Mbps in a full one hour time window.