Get Started

Quick Start

Build and run your first Bridge Kernel node in minutes.

Quick Start

This guide gets you from clone to first signed ledger event quickly.

Prerequisites

Rust toolchain (rustup, cargo)
Git

1. Clone the Bridge Kernel repo

git clone https://github.com/joulebridge/bridge-kernel.git
cd bridge-kernel

2. Create local config

cp bridge.example.yaml bridge.yaml

3. Build release binary

cargo build --release

4. Run one ingest cycle with mock adapter

./target/release/bridge-node ctl run-once --config bridge.yaml

5. Check runtime status

./target/release/bridge-node ctl status --config bridge.yaml

6. Inspect ledger summary

./target/release/bridge-node ctl ledger --config bridge.yaml

7. View metrics snapshot

./target/release/bridge-node ctl metrics --config bridge.yaml

What success looks like

Ingest counters increase.
Ledger event count is non-zero.
Runtime health is ok or explains degradation reasons.

Next

Getting Started

Everything you need to start using Bridge Kernel — from first install to your first signed ledger event.

Beginner Guide

Beginner-friendly explanation of how Bridge Kernel works.

On this page

Quick Start Prerequisites 1. Clone the Bridge Kernel repo 2. Create local config 3. Build release binary 4. Run one ingest cycle with mock adapter 5. Check runtime status 6. Inspect ledger summary 7. View metrics snapshot What success looks like Next