Skip to main content

Configuration

Fivemanage Lite is configured entirely via environment variables. This makes it easy to deploy in containerized environments like Docker and Kubernetes.

Environment Variables

Infrastructure Dependencies

To run a fully functional instance, you must provision the following dependencies:

1. PostgreSQL (Primary Database)

Used for storing relational data, including user accounts, organization hierarchies, file metadata, and API tokens.
  • Version: 14+ recommended.
  • Connection: Configured via the DSN environment variable.

2. ClickHouse (Log Store)

Used for the high-performance ingestion and querying of structured logs. This is mandatory if you intend to use the logging features.
  • Why ClickHouse?: It handles millions of log rows with minimal storage footprint and instant query speeds compared to traditional SQL databases.

3. S3-Compatible Storage

Used for storing actual file assets (images, user uploads).
  • Supported Providers: AWS S3, Cloudflare R2, or MinIO (for self-hosting).

4. OpenTelemetry (Optional)

The application has native tracing support. You can connect it to a collector like Jaeger to visualize request flows and performance bottlenecks.