Configuration Overview
Easy AppServer configuration through environment variables and config files.
Configuration Sources
- Environment Variables - Primary configuration method (12-factor app)
- Config Files - YAML/JSON configuration (optional)
- Defaults - Sensible defaults for development
Configuration Sections
- Environment Variables - Complete environment variable reference
- Server Configuration - HTTP, gRPC, GraphQL server settings
- Database Configuration - PostgreSQL connection and pooling
- Auth Services Configuration - Kratos, Hydra, OpenFGA, Oathkeeper
- Telemetry Configuration - Logging, metrics, tracing
Environment-Specific Configuration
TODO: Document environment-specific configs:
Development
- GraphQL Playground enabled
- gRPC reflection enabled
- Bootstrap registration allowed
- In-memory event bus
- Verbose logging
Production
- TLS/mTLS enforced
- Bootstrap registration disabled
- RabbitMQ event bus required
- INFO level logging
- Security headers enforced
Configuration Best Practices
TODO: Document best practices:
- Use environment variables for secrets
- Never commit secrets to git
- Use
.envfiles for local development - Document all configuration options
- Provide sensible defaults
- Validate configuration on startup