Skip to main content

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

Development Configuration

Production Configuration

TLS/mTLS Configuration

Server TLS

gRPC Client TLS (to Wallet-Core)

Validation

The configuration loader validates required fields:

Troubleshooting

  • Verify file path is correct
  • Check file permissions
  • Use absolute path with -config flag
  • Verify variable is exported
  • Use ${VAR:default} syntax for defaults
  • Check for typos in variable names
  • Verify DSN format
  • Check network connectivity
  • Ensure database exists
  • Verify credentials
  • 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