Skip to content

Commit 1a418cc

Browse files
committed
chore: document all configurable ENV variables in Dockerfile
Add missing ENV declarations for: - Telemetry (Enabled, ServiceName, Console, Otlp:Endpoint) — key fix: endpoint defaults to empty so no telemetry is sent without explicit opt-in - License (HubUrl, FilePath, HeartbeatEnabled, HeartbeatIntervalMinutes, PublicKeyPem) - BLiteServer:MaxPageSizeBytes - Transactions:TimeoutSeconds - QueryCache (Enabled, MaxSizeBytes) - Logging:LogLevel:Default
1 parent cbabc64 commit 1a418cc

1 file changed

Lines changed: 32 additions & 0 deletions

File tree

Dockerfile

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,14 +57,46 @@ ENV STUDIO__HOST=
5757
# Data paths — mount a volume at /data to persist the database
5858
ENV BLITESERVER__DATABASEPATH=/data/blite.db
5959
ENV BLITESERVER__DATABASESDIRECTORY=/data/tenants
60+
# Page size in bytes for the storage engine (default: 16384). Must be a power of 2.
61+
ENV BLITESERVER__MAXPAGESIZEBYTES=16384
6062

63+
# License management
6164
# AGPLv3 §13 source disclosure URL (override if you self-host a fork)
6265
ENV LICENSE__SOURCEURL=https://github.com/EntglDb/BLite.Server
66+
# URL of the BLite License Hub (for commercial license validation)
67+
ENV LICENSE__HUBURL=https://licensehub.blitedb.com
68+
# Path to a license file on disk (leave empty to use Hub-based validation)
69+
ENV LICENSE__FILEPATH=
70+
# Whether to send periodic heartbeat pings to the License Hub
71+
ENV LICENSE__HEARTBEATENABLED=true
72+
ENV LICENSE__HEARTBEATINTERVALMINUTES=60
73+
# PEM-encoded public key used to verify offline license files (leave empty for Hub validation)
74+
ENV LICENSE__PUBLICKEYPEM=
6375

6476
# Root API key — set Auth__RootKey to provision the root user on first start.
6577
# After the first start the value is no longer required (setup is persisted).
6678
# Example: -e Auth__RootKey=my-secret-key
6779

80+
# Telemetry / OpenTelemetry
81+
# Set Telemetry__Otlp__Endpoint to your OTLP collector URL to enable export.
82+
# Leave empty (default) to disable all OTLP export.
83+
ENV TELEMETRY__ENABLED=true
84+
ENV TELEMETRY__SERVICENAME=blite-server
85+
ENV TELEMETRY__CONSOLE=false
86+
ENV TELEMETRY__OTLP__ENDPOINT=
87+
88+
# Transaction timeout (seconds). A transaction not committed/rolled back within
89+
# this window is automatically aborted.
90+
ENV TRANSACTIONS__TIMEOUTSECONDS=60
91+
92+
# Query result cache
93+
ENV QUERYCACHE__ENABLED=true
94+
# Maximum in-memory size of the query cache in bytes (default: 64 MB)
95+
ENV QUERYCACHE__MAXSIZEBYTES=67108864
96+
97+
# Log level: Trace | Debug | Information | Warning | Error | Critical
98+
ENV LOGGING__LOGLEVEL__DEFAULT=Information
99+
68100
ENV ASPNETCORE_ENVIRONMENT=Production
69101

70102
# ── Volumes & ports ────────────────────────────────────────────────────────────

0 commit comments

Comments
 (0)