System Requirements
Clementine requires:- Rust: Version 1.88.0 or later
- RISC Zero: Version 2.1.0
- Bitcoin Core: Version 29.0 or later
- PostgreSQL: Version 15 or later
Minimum Stack Size
You must set theRUST_MIN_STACK environment variable:
Platform-Specific Dependencies
macOS
On macOS, you need to install Xcode and its command-line tools:Install Xcode from the App Store if the
xcrun metal command gives an error.Ubuntu/Debian
On Ubuntu and Debian-based systems, install the build essentials and development libraries:External Services
Before running Clementine, you’ll need to set up the following services:Bitcoin Node
Clementine requires a Bitcoin node running version 29.0 or later. Configure your node with:- RPC server enabled
- Proper authentication credentials
- Appropriate network mode (mainnet, testnet4, or regtest)
PostgreSQL Database
You need a PostgreSQL database (version 15 or later) for storing Clementine’s state and transaction data. The database can be shared between services run by the same entity.Citrea RPC (Optional)
If you’re integrating with Citrea, you’ll need:- Citrea RPC URL
- Citrea Light Client Prover URL
- Bridge contract address
Development vs Production
Development Mode
For development and testing, you can enable RISC Zero’s development mode:Production Requirements
For production deployments:- Valid TLS certificates (not self-signed)
- Proper certificate rotation policies
- Production-grade Bitcoin node
- Production-grade PostgreSQL database with appropriate connection limits
- BitVM cache files (optional but recommended)