Wallet-Core Configuration
Wallet-Core is configured via YAML files with environment variable expansion.Configuration Files
Loading Configuration
Complete Configuration Reference
Environment Variable Overrides
Configuration by Section
- Server
- Database
- TLS
- Ledger
Development Configuration
Production Configuration
TLS Configuration
Server-side TLS
Mutual TLS (mTLS)
Generating Certificates
Database Configuration
Connection String Format
SSL Modes
Connection Pool Tuning
Migrations
Migrations run automatically at startup. To disable:Troubleshooting
Database connection failed
Database connection failed
- Verify DSN format is correct
- Check network connectivity to database
- Ensure database exists
- Verify credentials
gRPC server failed to start
gRPC server failed to start
- Check if port is already in use
- Verify TLS certificates exist and are valid
- Check file permissions on cert files
Migrations failed
Migrations failed
- Check database user has CREATE TABLE permissions
- Review migration logs for specific errors
- Ensure database is accessible
VULT integration errors
VULT integration errors
- Verify VULT_BASE_URL is correct
- Check VULT_API_KEY is valid
- Ensure network access to VULT API
Next Steps
Ledger
Transaction processing details
Deployment
Production deployment guide