Gateway Configuration
The Gateway is configured via YAML files with environment variable expansion support.Configuration Files
Loading Configuration
Complete Configuration Reference
Environment Variable Overrides
The following environment variables override configuration:Configuration by Section
- Server
- Database
- Wallet-Core
- Rate Limiting
Development Configuration
Production Configuration
TLS/mTLS Configuration
Server TLS
gRPC Client TLS (to Wallet-Core)
Validation
The configuration loader validates required fields:Troubleshooting
Config file not found
Config file not found
- Verify file path is correct
- Check file permissions
- Use absolute path with
-configflag
Environment variables not expanded
Environment variables not expanded
- Verify variable is exported
- Use
${VAR:default}syntax for defaults - Check for typos in variable names
Database connection failed
Database connection failed
- Verify DSN format
- Check network connectivity
- Ensure database exists
- Verify credentials
gRPC connection failed
gRPC connection failed
- Verify wallet-core is running
- Check address and port
- If TLS enabled, verify certificates
Next Steps
API Reference
Complete endpoint documentation
Deployment
Production deployment guide