Quickstart
Get a QoreChain node running in minutes. Choose Docker Compose for the fastest setup, or build from source for full control.
Docker Compose (Recommended)
The simplest way to run a full QoreChain environment with all services pre-configured.
git clone https://github.com/qorechain/qorechain-core.git
cd qorechain-core
docker compose up -d
This starts the following services:
| Service | Ports | Description |
|---|---|---|
| qorechain-node | 26657 (RPC), 1317 (REST), 9090 (gRPC), 8545 (EVM), 8899 (SVM) | Full blockchain node with multi-VM support |
| ai-sidecar | 50051 | QCAI anomaly detection and risk scoring engine |
| indexer | -- | Block indexer for historical queries |
| postgres | 5432 | Database backend for the indexer |
| prometheus | 9091 | Metrics collection |
| grafana | 3001 | Monitoring dashboards |
Once all containers are healthy, your node begins syncing with the network.
Build from Source
Prerequisites
- Go 1.26+ with CGO enabled
- Rust toolchain (for compiling PQC cryptography and SVM runtime libraries)
- Git
Build the Binary
CGO_ENABLED=1 go build -o qorechaind ./cmd/qorechaind/
Initialize the Node
./qorechaind init my-node --chain-id qorechain-diana
This creates the default configuration and data directories under ~/.qorechaind/.
Start the Node
./qorechaind start
The node starts with default settings. See Connecting to Testnet for joining the live network with proper genesis and peer configuration.
The examples on this page target the qorechain-diana testnet (EVM chain ID 9800). Mainnet (qorechain-vladi, EVM chain ID 9801) has been live since 7 June 2026 and has its own dedicated Connecting to Mainnet page.
Verify Installation
Confirm your node is running correctly:
# Check the binary version
./qorechaind version
# Query the node status via RPC
curl localhost:26657/status
A successful response includes the node's moniker, network (should be qorechain-diana), and current block height.
Next Steps
- Connecting to Testnet — Join the live Diana testnet
- Wallet Setup — Configure a wallet to interact with the chain
- Your First Transaction — Send your first QOR transfer
- Connecting to Mainnet — Join the live Vladi mainnet
- SDK Overview — Build applications against QoreChain from code