This guide walks you through building and running StrikeHub on your local machine.
Prerequisites
- Rust 1.91.1+ (check with
rustup show) - macOS or Linux (macOS is the primary platform)
- Prospector Studio (for authentication and platform features)
Clone and Build
git clone https://github.com/Strike48-public/strikehub.git
cd strikehub
cargo run --features desktop
For a release build:
cargo build --release --features desktop
./target/release/strikehub
Environment Variables
Set these before running StrikeHub:
| Variable | Purpose | Required |
|---|---|---|
STRIKE48_API_URL |
Strike48 API / Keycloak server URL | For auth |
MATRIX_TLS_INSECURE |
Skip TLS verification (true / 1) |
No |
RUST_LOG |
Logging level (info, debug) |
No |
Example:
RUST_LOG=debug STRIKE48_API_URL=https://studio.strike48.test cargo run --features desktop
First Launch
- StrikeHub opens with a sidebar and a welcome screen.
- Built-in connector manifests (KubeStudio, JiraStudio, etc.) appear in the sidebar with offline status.
- Start a connector — either from the UI or by running the connector binary separately.
- Once the connector is running, its status turns green and you can click to load its UI in the content panel.
What's Next
- Configuration — Customize connectors.toml and environment variables
- Connectors — Understand the IPC transport and content delivery pipeline
- Installation — Platform-specific build details