Environment Variables

Every config key supported by Lakta can be set via an environment variable. This is useful for secrets, deployment-time overrides, and container environments.

Naming convention

Transform the dot-notation config key:

Prefix with LAKTA_
Convert to uppercase
Replace each path-separating . with a double underscore (__)
Leave underscores inside a key (e.g. max_open_conns) as single underscores

The double-underscore separator is what lets a snake_case key survive: a single underscore everywhere would be ambiguous between a path boundary and the underscore inside the key.

Examples:

| Config key | Environment variable | |------------|---------------------| | modules.grpc.server.default.port | LAKTA_MODULES__GRPC__SERVER__DEFAULT__PORT | | modules.db.pgx.primary.dsn | LAKTA_MODULES__DB__PGX__PRIMARY__DSN | | modules.db.pgx.default.max_open_conns | LAKTA_MODULES__DB__PGX__DEFAULT__MAX_OPEN_CONNS | | modules.http.fiber.default.health_path | LAKTA_MODULES__HTTP__FIBER__DEFAULT__HEALTH_PATH |

Priority

Environment variables override config file values but are overridden by CLI flags:

config file < environment variable < CLI flag

Docker / Kubernetes example

# kubernetes deployment
env:
  - name: LAKTA_MODULES__DB__PGX__DEFAULT__DSN
    valueFrom:
      secretKeyRef:
        name: db-secret
        key: dsn
  - name: LAKTA_MODULES__OTEL__OTEL__DEFAULT__ENDPOINT
    value: "http://otel-collector:4317"

Full reference

Generated from the module config structs (showing the default instance). Swap DEFAULT for any instance name.

modules.db.pgx

Config key	Environment variable
`modules.db.pgx.default.dsn`	`LAKTA_MODULES__DB__PGX__DEFAULT__DSN`
`modules.db.pgx.default.max_open_conns`	`LAKTA_MODULES__DB__PGX__DEFAULT__MAX_OPEN_CONNS`
`modules.db.pgx.default.log_level`	`LAKTA_MODULES__DB__PGX__DEFAULT__LOG_LEVEL`
`modules.db.pgx.default.health_check`	`LAKTA_MODULES__DB__PGX__DEFAULT__HEALTH_CHECK`
`modules.db.pgx.default.min_conns`	`LAKTA_MODULES__DB__PGX__DEFAULT__MIN_CONNS`
`modules.db.pgx.default.max_conn_lifetime`	`LAKTA_MODULES__DB__PGX__DEFAULT__MAX_CONN_LIFETIME`
`modules.db.pgx.default.max_conn_idle_time`	`LAKTA_MODULES__DB__PGX__DEFAULT__MAX_CONN_IDLE_TIME`
`modules.db.pgx.default.health_check_period`	`LAKTA_MODULES__DB__PGX__DEFAULT__HEALTH_CHECK_PERIOD`
`modules.db.pgx.default.statement_timeout`	`LAKTA_MODULES__DB__PGX__DEFAULT__STATEMENT_TIMEOUT`

modules.grpc.client

Config key	Environment variable
`modules.grpc.client.default.target`	`LAKTA_MODULES__GRPC__CLIENT__DEFAULT__TARGET`
`modules.grpc.client.default.insecure`	`LAKTA_MODULES__GRPC__CLIENT__DEFAULT__INSECURE`
`modules.grpc.client.default.tls`	`LAKTA_MODULES__GRPC__CLIENT__DEFAULT__TLS`

modules.grpc.server

Config key	Environment variable
`modules.grpc.server.default.host`	`LAKTA_MODULES__GRPC__SERVER__DEFAULT__HOST`
`modules.grpc.server.default.port`	`LAKTA_MODULES__GRPC__SERVER__DEFAULT__PORT`
`modules.grpc.server.default.health_check`	`LAKTA_MODULES__GRPC__SERVER__DEFAULT__HEALTH_CHECK`
`modules.grpc.server.default.tls`	`LAKTA_MODULES__GRPC__SERVER__DEFAULT__TLS`

modules.health.health

Config key	Environment variable
`modules.health.health.default.component_name`	`LAKTA_MODULES__HEALTH__HEALTH__DEFAULT__COMPONENT_NAME`
`modules.health.health.default.component_version`	`LAKTA_MODULES__HEALTH__HEALTH__DEFAULT__COMPONENT_VERSION`

modules.http.fiber

Config key	Environment variable
`modules.http.fiber.default.host`	`LAKTA_MODULES__HTTP__FIBER__DEFAULT__HOST`
`modules.http.fiber.default.port`	`LAKTA_MODULES__HTTP__FIBER__DEFAULT__PORT`
`modules.http.fiber.default.health_path`	`LAKTA_MODULES__HTTP__FIBER__DEFAULT__HEALTH_PATH`
`modules.http.fiber.default.tls`	`LAKTA_MODULES__HTTP__FIBER__DEFAULT__TLS`

modules.logging.slog

Config key	Environment variable
`modules.logging.slog.default.level`	`LAKTA_MODULES__LOGGING__SLOG__DEFAULT__LEVEL`
`modules.logging.slog.default.levels`	`LAKTA_MODULES__LOGGING__SLOG__DEFAULT__LEVELS`
`modules.logging.slog.default.global_default`	`LAKTA_MODULES__LOGGING__SLOG__DEFAULT__GLOBAL_DEFAULT`

modules.logging.tint

Config key	Environment variable
`modules.logging.tint.default.time_format`	`LAKTA_MODULES__LOGGING__TINT__DEFAULT__TIME_FORMAT`

modules.otel.otel

Config key	Environment variable
`modules.otel.otel.default.service_name`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__SERVICE_NAME`
`modules.otel.otel.default.service_version`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__SERVICE_VERSION`
`modules.otel.otel.default.service_namespace`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__SERVICE_NAMESPACE`
`modules.otel.otel.default.environment`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__ENVIRONMENT`
`modules.otel.otel.default.endpoint`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__ENDPOINT`
`modules.otel.otel.default.protocol`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__PROTOCOL`
`modules.otel.otel.default.insecure`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__INSECURE`
`modules.otel.otel.default.headers`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__HEADERS`
`modules.otel.otel.default.sample_rate`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__SAMPLE_RATE`
`modules.otel.otel.default.metric_interval`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__METRIC_INTERVAL`
`modules.otel.otel.default.runtime_interval`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__RUNTIME_INTERVAL`
`modules.otel.otel.default.enabled`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__ENABLED`
`modules.otel.otel.default.required`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__REQUIRED`
`modules.otel.otel.default.signals`	`LAKTA_MODULES__OTEL__OTEL__DEFAULT__SIGNALS`

modules.workflows.temporal

Config key	Environment variable
`modules.workflows.temporal.default.target`	`LAKTA_MODULES__WORKFLOWS__TEMPORAL__DEFAULT__TARGET`
`modules.workflows.temporal.default.task_queue`	`LAKTA_MODULES__WORKFLOWS__TEMPORAL__DEFAULT__TASK_QUEUE`
`modules.workflows.temporal.default.namespace`	`LAKTA_MODULES__WORKFLOWS__TEMPORAL__DEFAULT__NAMESPACE`
`modules.workflows.temporal.default.insecure`	`LAKTA_MODULES__WORKFLOWS__TEMPORAL__DEFAULT__INSECURE`