5.1.1.1 Parachain on Kusama

The Integritee parachains are compatible with the polkadot-omni-node, therefore, there is no need to use Integritee's collator release. Instead, we recommend to use the latest polkadot-omni-node.

due to a bug in our early chain history, the sync will stall at block #38220. See Troubleshooting for a fix.

Spec Requirement

We suggest to meet these minimal requirements although slightly weaker HW may work as well:

2TB NVMe SSD.
- seq. write performance should be > 1000 MB/s. Consider that SSD's get slower the more full they get. Also, they wear out with intense usage)
16GB RAM
CPU won't matter much, but go for maximum single-core performance rather than many cores.

Build the Omni-Node

Skip this step if you want to use the pre-built binary.

We assume you're building on ubuntu 22.04

sudo apt update && sudo apt upgrade
sudo apt install -y build-essential clang curl git jq libssl-dev pkg-config protobuf-compiler
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env
rustup target add wasm32-unknown-unknown
cargo install polkadot-omni-node

Run Collator as a Systemd Service

We assume you use ubuntu 22.04.

Download

polkadot-omni-node binary here
ìntegritee-kusama.spec` from here

Create /etc/systemd/system/integritee-kusama-collator.service with the following content:

[Unit]
Description=Integritee Kusama Collator

[Service]
User=integritee
Group=collators

ExecStart=/path/to/polkadot-omni-node \
  # only if you intend to produce blocks
  --validator \
  --chain=/home/integritee/integritee-kusama/integritee-kusama.json \
  # adjust
  --name my-fancy-integritee-node \
  # we recommend to both these endpoints
  --telemetry-url "wss://telemetry.polkadot.io/submit/ 0"
  --telemetry-url 'wss://shard.telemetry.integritee.io/submit/ 1' \
  # adjust the base path to your needs
  --base-path '/opt/integritee' \
  # archive pruning is recommended if you want to run indexers on the node
  --state-pruning archive \ 
  --blocks-pruning archive \
  --pool-type=fork-aware \
    -- \
  --sync=warp \
  --chain kusama \
  --telemetry-url "wss://telemetry.polkadot.io/submit/ 0"
  # adjust the base path to your needs
  --base-path '/opt/integritee' \
  
Restart=always
RestartSec=60

[Install]
WantedBy=multi-user.target

Using Docker

use image: parity/polkadot-omni-node

Download

ìntegritee-kusama.spec` from here

{% code overflow="wrap" lineNumbers="true" %}

docker pull parity/polkadot-omni-node
docker run parity/polkadot-omni-node --chain=integritee-kusama.json -- --chain=kusama`

{% endcode %}

For additional cli args, see above.

Starting from a Snapshot

We provide our latest snapshots for you to reduce your sync time.

To download and extract on the fly, use e.g.:

curl -o - -L https://pub-84166bba27804f48a67cf8cc4f3cd0a6.r2.dev/integritee-kusama-snapshot-20250314-rocksdb-archive.tar.lz4 | lz4 -c -d - | tar -x -C /path/chains/integritee-kusama/

For relaychain snapshots, please see: https://snapshots.polkadot.io/

Troubleshooting

Due to a configuration error, a sync from scratch stalls at block #38220. More info: https://github.com/integritee-network/parachain/issues/84

The solution is straightforward and - if required - trustless. Please select one of the options below:

The Fix

Trustless: Build the fix yourself

Checkout our fix branch https://github.com/integritee-network/parachain/tree/skip-signature-verification
Build the code as it is described in Run from source code section
Once the sync left #38220 one should stop it and continue with the latest polkadot-omni-node.

As the fix hasn't been upgraded with later PolkadotSDK versions, here's the old cli syntax to run the fix and sync an initial RocksDb:

./integritee-collator-accept-all-signatures \
  --base-path '<add your path or delete this line>' \
  --pruning archive \ 
  --chain=integritee-kusama \
  -- \
  --base-path '<add your path or delete this line>' \
  --chain=kusama \

Using our pre-built binary

Download https://github.com/integritee-network/parachain/releases/download/1.5.15/integritee-collator-accept-all-signatures , replace it with integritee binary. Follow the instructions above to run the fix.
Once the sync left #38220 one should stop it and continue with the latest polkadot-omni-node.

Start from a Snapshot

Start with one of our snapshots generated later than block #48375.

Integritee Network Docs